« back to all changes in this revision
Viewing changes to doc/html/ddd.html
- browse files at revision 5
- compare with another revision
- download diff
- download tarball
- view history from revision 5
- Committer: Bazaar Package Importer
- Author(s): Daniel Schepler
- Date: 2009-11-10 14:01:10 UTC
- mfrom: (1.2.3 upstream)
- Revision ID: james.westby@ubuntu.com-20091110140110-lbqo0psrkkzd0j1k
Tags: 1:3.3.12-1
* New upstream release. Closes: #555511. Thanks to giagimari@libero.it
for pointing out that upstream had moved.
+ Includes new .desktop file. Closes: #513640.
* Put version on lpr Build-Depends to make sure providing package
doesn't result in wrong command in app-default file.
* Adjust Build-Depends for readline 6 transition. Closes: #553746.
* Fix build error with g++-4.4. Closes: #504868.
* Minor improvement to package description, thanks to Reuben Thomas.
Closes: #460139.
for pointing out that upstream had moved.
+ Includes new .desktop file. Closes: #513640.
* Put version on lpr Build-Depends to make sure providing package
doesn't result in wrong command in app-default file.
* Adjust Build-Depends for readline 6 transition. Closes: #553746.
* Fix build error with g++-4.4. Closes: #504868.
* Minor improvement to package description, thanks to Reuben Thomas.
Closes: #460139.
- files added:
- COPYING.LESSER
- vsllib/DEMOS
- files removed:
- COPYING.LIB
- etc
- files modified:
- AUTHORS
added
removed
doc/html/ddd.html
1
<html lang="en">
2
<head>
3
<title>Debugging with DDD</title>
4
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
5
<meta name="description" content="Debugging with DDD">
6
<meta name="generator" content="makeinfo 4.11">
7
<link title="Top" rel="top" href="#Top">
8
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
9
<meta http-equiv="Content-Style-Type" content="text/css">
10
<style type="text/css"><!--
11
pre.display { font-family:inherit }
12
pre.format { font-family:inherit }
13
pre.smalldisplay { font-family:inherit; font-size:smaller }
14
pre.smallformat { font-family:inherit; font-size:smaller }
15
pre.smallexample { font-size:smaller }
16
pre.smalllisp { font-size:smaller }
17
span.sc { font-variant:small-caps }
18
span.roman { font-family:serif; font-weight:normal; }
19
span.sansserif { font-family:sans-serif; font-weight:normal; }
20
--></style>
21
<link rel=StyleSheet HREF="style.css" type="text/css" media=screen>
22
<link rel=author href="mailto:zeller@gnu.org">
23
</head>
24
<body bgcolor="#ffffff">
1
25
<div class="node">
2
26
<p><hr>
3
<small class=header>
4
Node:<a name="Top">Top</a>,
5
Next:<a rel="next" accesskey="n" href="#Summary">Summary</a>,
6
Up:<a rel="up" accesskey="u" href="#dir">(dir)</a>
27
<a name="Top"></a>
28
Next: <a rel="next" accesskey="n" href="#Summary">Summary</a>,
29
Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
7
30
</small>
8
31
9
<br>
32
10
33
</div>
11
34
12
35
<h2 class="unnumbered">Debugging with DDD</h2>
13
36
14
<p><small>DDD</small> is a graphical front-end for <small>GDB</small> and other command-line
37
<p><acronym>DDD</acronym> is a graphical front-end for <acronym>GDB</acronym> and other command-line
15
38
debuggers.
16
39
17
40
<p>This is the First Edition of <cite>Debugging with
18
</cite><small>DDD</small><cite></cite>, 15 January, 2004, for <small>DDD</small> Version 3.3.11.
41
<acronym>DDD</acronym></cite>, 8 Feb, 2009, for <acronym>DDD</acronym> Version 3.3.12.
19
42
20
43
<ul class="menu">
21
<li><a accesskey="1" href="#Summary">Summary</a>: Summary of <small>DDD</small>.
44
<li><a accesskey="1" href="#Summary">Summary</a>: Summary of <acronym>DDD</acronym>.
22
45
23
<p>
24
</p><li><a accesskey="2" href="#Sample%20Session">Sample Session</a>: A sample <small>DDD</small> session.
25
<li><a accesskey="3" href="#Invocation">Invocation</a>: Getting in and out of <small>DDD</small>.
26
<li><a accesskey="4" href="#Windows">Windows</a>: The <small>DDD</small> windows, menus, and buttons.
46
<li><a accesskey="2" href="#Sample-Session">Sample Session</a>: A sample <acronym>DDD</acronym> session.
47
<li><a accesskey="3" href="#Invocation">Invocation</a>: Getting in and out of <acronym>DDD</acronym>.
48
<li><a accesskey="4" href="#Windows">Windows</a>: The <acronym>DDD</acronym> windows, menus, and buttons.
27
49
<li><a accesskey="5" href="#Navigating">Navigating</a>: Moving through the source code.
28
50
<li><a accesskey="6" href="#Stopping">Stopping</a>: Making your program stop at specific locations.
29
<li><a accesskey="7" href="#Running">Running</a>: Running programs under <small>DDD</small>.
30
<li><a accesskey="8" href="#Examining%20Data">Examining Data</a>: Examining variable values and data structures.
31
<li><a accesskey="9" href="#Machine-Level%20Debugging">Machine-Level Debugging</a>: Examining machine code and registers.
32
<li><a href="#Changing%20the%20Program">Changing the Program</a>: Changing source and object code.
33
<li><a href="#Commands">Commands</a>: Entering and editing <small>DDD</small> commands.
51
<li><a accesskey="7" href="#Running">Running</a>: Running programs under <acronym>DDD</acronym>.
52
<li><a accesskey="8" href="#Examining-Data">Examining Data</a>: Examining variable values and data structures.
53
<li><a accesskey="9" href="#Machine_002dLevel-Debugging">Machine-Level Debugging</a>: Examining machine code and registers.
54
<li><a href="#Changing-the-Program">Changing the Program</a>: Changing source and object code.
55
<li><a href="#Commands">Commands</a>: Entering and editing <acronym>DDD</acronym> commands.
34
56
35
<p>
36
</p><li><a href="#Application%20Defaults">Application Defaults</a>: Resources used in <small>DDD</small>.
37
<li><a href="#Bugs">Bugs</a>: How, when, and why to report <small>DDD</small> bugs.
38
<li><a href="#Configuration%20Notes">Configuration Notes</a>: Configuration-specific notes.
39
<li><a href="#Dirty%20Tricks">Dirty Tricks</a>: Room for your contributions.
40
<li><a href="#Extending">Extending</a>: Extending <small>DDD</small>.
57
<li><a href="#Application-Defaults">Application Defaults</a>: Resources used in <acronym>DDD</acronym>.
58
<li><a href="#Bugs">Bugs</a>: How, when, and why to report <acronym>DDD</acronym> bugs.
59
<li><a href="#Configuration-Notes">Configuration Notes</a>: Configuration-specific notes.
60
<li><a href="#Dirty-Tricks">Dirty Tricks</a>: Room for your contributions.
61
<li><a href="#Extending">Extending</a>: Extending <acronym>DDD</acronym>.
41
62
<li><a href="#FAQ">FAQ</a>: Frequently Answered Questions.
42
<li><a href="#License">License</a>: The <small>DDD</small> license.
43
<li><a href="#Help%20and%20Assistance">Help and Assistance</a>: Mailing Lists and other resources.
44
<li><a href="#Documentation%20License">Documentation License</a>: The license of this document.
63
<li><a href="#License">License</a>: The <acronym>DDD</acronym> license.
64
<li><a href="#Help-and-Assistance">Help and Assistance</a>: Mailing Lists and other resources.
65
<li><a href="#Documentation-License">Documentation License</a>: The license of this document.
45
66
46
<p>
47
</p><li><a href="#Label%20Index">Label Index</a>: All labels shown on the <small>DDD</small> <small>GUI</small>.
48
<li><a href="#Key%20Index">Key Index</a>: Keys used to control <small>DDD</small>.
49
<li><a href="#Command%20Index">Command Index</a>: Commands that can be typed within <small>DDD</small>.
50
<li><a href="#Resource%20Index">Resource Index</a>: All resources and environment variables.
51
<li><a href="#File%20Index">File Index</a>: All programs and files referenced by <small>DDD</small>.
52
<li><a href="#Concept%20Index">Concept Index</a>: All concepts as mentioned in this manual.
67
<li><a href="#Label-Index">Label Index</a>: All labels shown on the <acronym>DDD</acronym> <acronym>GUI</acronym>.
68
<li><a href="#Key-Index">Key Index</a>: Keys used to control <acronym>DDD</acronym>.
69
<li><a href="#Command-Index">Command Index</a>: Commands that can be typed within <acronym>DDD</acronym>.
70
<li><a href="#Resource-Index">Resource Index</a>: All resources and environment variables.
71
<li><a href="#File-Index">File Index</a>: All programs and files referenced by <acronym>DDD</acronym>.
72
<li><a href="#Concept-Index">Concept Index</a>: All concepts as mentioned in this manual.
53
73
54
74
</ul>
55
75
56
57
<div class="contents">
76
<div class="contents">
58
77
<h2>Table of Contents</h2>
59
78
<ul>
60
79
<li><a name="toc_Top" href="#Top">Debugging with DDD</a>
61
80
<li><a name="toc_Summary" href="#Summary">Summary of DDD</a>
62
81
<ul>
63
<li><a href="#About%20this%20Manual">About this Manual</a>
64
<li><a href="#Typographic%20Conventions">Typographic conventions</a>
65
<li><a href="#Free%20Software">Free software</a>
66
<li><a href="#Getting%20%3csmall%3eDDD%3c%2fsmall%3e">Getting DDD</a>
82
<li><a href="#About-this-Manual">About this Manual</a>
83
<li><a href="#Typographic-Conventions">Typographic conventions</a>
84
<li><a href="#Free-Software">Free software</a>
85
<li><a href="#Getting-_003cacronym_003eDDD_003c_002facronym_003e">Getting DDD</a>
67
86
<li><a href="#Contributors">Contributors to DDD</a>
68
87
<li><a href="#History">History of DDD</a>
69
88
</li></ul>
70
<li><a name="toc_Sample%20Session" href="#Sample%20Session">A Sample DDD Session</a>
71
<ul>
72
<li><a href="#Sample%20Program">Sample Program</a>
73
</li></ul>
74
<li><a name="toc_Invocation" href="#Invocation">Getting In and Out of DDD</a>
75
<ul>
76
<li><a href="#Invoking">Invoking DDD</a>
77
<ul>
78
<li><a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>
79
<li><a href="#Options">DDD Options</a>
80
<li><a href="#X%20Options">X Options</a>
81
<li><a href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>
82
<ul>
83
<li><a href="#GDB%20Options">GDB Options</a>
84
<li><a href="#DBX%20and%20Ladebug%20Options">DBX and Ladebug Options</a>
85
<li><a href="#XDB%20Options">XDB Options</a>
86
<li><a href="#JDB%20Options">JDB Options</a>
87
<li><a href="#PYDB%20Options">PYDB Options</a>
88
<li><a href="#Perl%20Options">Perl Options</a>
89
<li><a href="#Bash%20Options">Bash Options</a>
90
</li></ul>
91
<li><a href="#Multiple%20Instances">Multiple DDD Instances</a>
92
<li><a href="#X%20Warnings">X warnings</a>
93
</li></ul>
94
<li><a href="#Quitting">Quitting DDD</a>
95
<li><a href="#Sessions">Persistent Sessions</a>
96
<ul>
97
<li><a href="#Saving%20Sessions">Saving Sessions</a>
98
<li><a href="#Resuming%20Sessions">Resuming Sessions</a>
99
<li><a href="#Deleting%20Sessions">Deleting Sessions</a>
100
<li><a href="#Customizing%20Sessions">Customizing Sessions</a>
101
</li></ul>
102
<li><a href="#Remote%20Debugging">Remote Debugging</a>
103
<ul>
104
<li><a href="#Remote%20Host">Running DDD on a Remote Host</a>
105
<li><a href="#Remote%20Debugger">Using DDD with a Remote Inferior Debugger</a>
106
<ul>
107
<li><a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>
108
</li></ul>
109
<li><a href="#Remote%20Program">Debugging a Remote Program</a>
110
</li></ul>
111
<li><a href="#Customizing%20Debugger%20Interaction">Customizing Interaction with the Inferior Debugger</a>
112
<ul>
113
<li><a href="#Debugger%20Invocation">Invoking an Inferior Debugger</a>
114
<li><a href="#Debugger%20Initialization">Initializing the Inferior Debugger</a>
115
<ul>
116
<li><a href="#GDB%20Initialization">GDB Initialization</a>
117
<li><a href="#DBX%20Initialization">DBX Initialization</a>
118
<li><a href="#XDB%20Initialization">XDB Initialization</a>
119
<li><a href="#JDB%20Initialization">JDB Initialization</a>
120
<li><a href="#PYDB%20Initialization">PYDB Initialization</a>
121
<li><a href="#Perl%20Initialization">Perl Initialization</a>
122
<li><a href="#Bash%20Initialization">Bash Initialization</a>
123
<li><a href="#Finding%20a%20Place%20to%20Start">Finding a Place to Start</a>
124
<li><a href="#Opening%20the%20Selection">Opening the Selection</a>
125
</li></ul>
126
<li><a href="#Debugger%20Communication">Communication with the Inferior Debugger</a>
127
</li></ul>
128
</li></ul>
129
<li><a name="toc_Windows" href="#Windows">The DDD Windows</a>
130
<ul>
131
<li><a href="#Menu%20Bar">The Menu Bar</a>
132
<ul>
133
<li><a href="#File%20Menu">The File Menu</a>
134
<li><a href="#Edit%20Menu">The Edit Menu</a>
135
<li><a href="#View%20Menu">The View Menu</a>
136
<li><a href="#Program%20Menu">The Program Menu</a>
137
<li><a href="#Commands%20Menu">The Commands Menu</a>
138
<li><a href="#Status%20Menu">The Status Menu</a>
139
<li><a href="#Source%20Menu">The Source Menu</a>
140
<li><a href="#Data%20Menu">The Data Menu</a>
141
<li><a href="#Maintenance%20Menu">The Maintenance Menu</a>
142
<li><a href="#Help%20Menu">The Help Menu</a>
143
<li><a href="#Customizing%20the%20Menu%20Bar">Customizing the Menu Bar</a>
144
<ul>
145
<li><a href="#Auto-Raise%20Menus">Auto-Raise Menus</a>
146
<li><a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>
147
</li></ul>
148
</li></ul>
149
<li><a href="#Tool%20Bar">The Tool Bar</a>
150
<ul>
151
<li><a href="#Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>
152
</li></ul>
153
<li><a href="#Command%20Tool">The Command Tool</a>
154
<ul>
155
<li><a href="#Customizing%20the%20Command%20Tool">Customizing the Command Tool</a>
156
<ul>
157
<li><a href="#Disabling%20the%20Command%20Tool">Disabling the Command Tool</a>
158
</li></ul>
159
<li><a href="#Customizing%20Tool%20Position">Command Tool Position</a>
160
<ul>
161
<li><a href="#Customizing%20Tool%20Decoration">Customizing Tool Decoration</a>
162
</li></ul>
163
</li></ul>
164
<li><a href="#Getting%20Help">Getting Help</a>
165
<li><a href="#Undo%20and%20Redo">Undoing and Redoing Commands</a>
166
<li><a href="#Customizing">Customizing DDD</a>
167
<ul>
168
<li><a href="#How%20Customizing%20Works">How Customizing DDD Works</a>
169
<ul>
170
<li><a href="#Resources">Resources</a>
171
<li><a href="#Changing%20Resources">Changing Resources</a>
172
<li><a href="#Saving%20Options">Saving Options</a>
173
</li></ul>
174
<li><a href="#Customizing%20Help">Customizing DDD Help</a>
175
<ul>
176
<li><a href="#Button%20tips">Button Tips</a>
177
<li><a href="#Tip%20of%20the%20day">Tip of the day</a>
178
<li><a href="#Help%20Helpers">Help Helpers</a>
179
</li></ul>
180
<li><a href="#Customizing%20Undo">Customizing Undo</a>
181
<li><a href="#Customizing%20Windows">Customizing the DDD Windows</a>
182
<ul>
183
<li><a href="#Splash%20Screen">Splash Screen</a>
184
<li><a href="#Window%20Layout">Window Layout</a>
185
<li><a href="#Customizing%20Fonts">Customizing Fonts</a>
186
<li><a href="#Toggling%20Windows">Toggling Windows</a>
187
<li><a href="#Text%20Fields">Text Fields</a>
188
<li><a href="#Icons">Icons</a>
189
<li><a href="#Adding%20Buttons">Adding Buttons</a>
190
<li><a href="#More%20Customizations">More Customizations</a>
191
</li></ul>
192
<li><a href="#Debugger%20Settings">Debugger Settings</a>
193
</li></ul>
194
</li></ul>
195
<li><a name="toc_Navigating" href="#Navigating">Navigating through the Code</a>
196
<ul>
197
<li><a href="#Compiling%20for%20Debugging">Compiling for Debugging</a>
198
<li><a href="#Opening%20Files">Opening Files</a>
199
<ul>
200
<li><a href="#Opening%20Programs">Opening Programs</a>
201
<li><a href="#Opening%20Core%20Dumps">Opening Core Dumps</a>
202
<li><a href="#Opening%20Source%20Files">Opening Source Files</a>
203
<li><a href="#Filtering%20Files">Filtering Files</a>
204
</li></ul>
205
<li><a href="#Looking%20up%20Items">Looking up Items</a>
206
<ul>
207
<li><a href="#Looking%20up%20Definitions">Looking up Definitions</a>
208
<li><a href="#Textual%20Search">Textual Search</a>
209
<li><a href="#Looking%20up%20Previous%20Locations">Looking up Previous Locations</a>
210
<li><a href="#Source%20Path">Specifying Source Directories</a>
211
</li></ul>
212
<li><a href="#Customizing%20Source">Customizing the Source Window</a>
213
<ul>
214
<li><a href="#Customizing%20Glyphs">Customizing Glyphs</a>
215
<li><a href="#Customizing%20Searching">Customizing Searching</a>
216
<li><a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
217
<li><a href="#Customizing%20Source%20Scrolling">Customizing Source Scrolling</a>
218
<li><a href="#Customizing%20Source%20Lookup">Customizing Source Lookup</a>
219
<li><a href="#Customizing%20File%20Filtering">Customizing File Filtering</a>
220
</li></ul>
221
</li></ul>
222
<li><a name="toc_Stopping" href="#Stopping">Stopping the Program</a>
223
<ul>
224
<li><a href="#Breakpoints">Breakpoints</a>
225
<ul>
226
<li><a href="#Setting%20Breakpoints">Setting Breakpoints</a>
227
<ul>
228
<li><a href="#Setting%20Breakpoints">Setting Breakpoints by Location</a>
229
<li><a href="#Setting%20Breakpoints">Setting Breakpoints by Name</a>
230
<li><a href="#Setting%20Breakpoints">Setting Regexp Breakpoints</a>
231
</li></ul>
232
<li><a href="#Deleting%20Breakpoints">Deleting Breakpoints</a>
233
<li><a href="#Disabling%20Breakpoints">Disabling Breakpoints</a>
234
<li><a href="#Temporary%20Breakpoints">Temporary Breakpoints</a>
235
<li><a href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>
236
<li><a href="#Breakpoint%20Conditions">Breakpoint Conditions</a>
237
<li><a href="#Breakpoint%20Ignore%20Counts">Breakpoint Ignore Counts</a>
238
<li><a href="#Breakpoint%20Commands">Breakpoint Commands</a>
239
<li><a href="#Moving%20and%20Copying%20Breakpoints">Moving and Copying Breakpoints</a>
240
<li><a href="#Looking%20up%20Breakpoints">Looking up Breakpoints</a>
241
<li><a href="#Editing%20all%20Breakpoints">Editing all Breakpoints</a>
242
<li><a href="#Hardware-Assisted%20Breakpoints">Hardware-Assisted Breakpoints</a>
243
</li></ul>
244
<li><a href="#Watchpoints">Watchpoints</a>
245
<ul>
246
<li><a href="#Setting%20Watchpoints">Setting Watchpoints</a>
247
<li><a href="#Editing%20Watchpoint%20Properties">Editing Watchpoint Properties</a>
248
<li><a href="#Editing%20all%20Watchpoints">Editing all Watchpoints</a>
249
<li><a href="#Deleting%20Watchpoints">Deleting Watchpoints</a>
250
</li></ul>
251
<li><a href="#Interrupting">Interrupting</a>
252
<li><a href="#Stopping%20X%20Programs">Stopping X Programs</a>
253
<ul>
254
<li><a href="#Customizing%20Grab%20Checking">Customizing Grab Checking</a>
255
</li></ul>
256
</li></ul>
257
<li><a name="toc_Running" href="#Running">Running the Program</a>
258
<ul>
259
<li><a href="#Starting%20Program%20Execution">Starting Program Execution</a>
260
<ul>
261
<li><a href="#Arguments">Your Program's Arguments</a>
262
<li><a href="#Environment">Your Program's Environment</a>
263
<li><a href="#Working%20Directory">Your Program's Working Directory</a>
264
<li><a href="#Input%2fOutput">Your Program's Input and Output</a>
265
</li></ul>
266
<li><a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>
267
<ul>
268
<li><a href="#Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>
269
</li></ul>
270
<li><a href="#Attaching%20to%20a%20Process">Attaching to a Running Process</a>
271
<ul>
272
<li><a href="#Customizing%20Attaching%20to%20Processes">Customizing Attaching to Processes</a>
273
</li></ul>
274
<li><a href="#Program%20Stop">Program Stops</a>
275
<li><a href="#Resuming%20Execution">Resuming Execution</a>
276
<ul>
277
<li><a href="#Resuming%20Execution">Continuing</a>
278
<li><a href="#Resuming%20Execution">Stepping one Line</a>
279
<li><a href="#Resuming%20Execution">Continuing to the Next Line</a>
280
<li><a href="#Resuming%20Execution">Continuing Until Here</a>
281
<li><a href="#Resuming%20Execution">Continuing Until a Greater Line is Reached</a>
282
<li><a href="#Resuming%20Execution">Continuing Until Function Returns</a>
283
</li></ul>
284
<li><a href="#Continuing%20Somewhere%20Else">Continuing at a Different Address</a>
285
<li><a href="#Stack">Examining the Stack</a>
286
<ul>
287
<li><a href="#Frames">Stack Frames</a>
288
<li><a href="#Backtraces">Backtraces</a>
289
<li><a href="#Selecting%20a%20frame">Selecting a Frame</a>
290
</li></ul>
291
<li><a href="#Undoing%20Program%20Execution">"Undoing" Program Execution</a>
292
<li><a href="#Threads">Examining Threads</a>
293
<li><a href="#Signals">Handling Signals</a>
294
<li><a href="#Killing%20the%20Program">Killing the Program</a>
295
</li></ul>
296
<li><a name="toc_Examining%20Data" href="#Examining%20Data">Examining Data</a>
297
<ul>
298
<li><a href="#Value%20Tips">Showing Simple Values using Value Tips</a>
299
<li><a href="#Printing%20Values">Printing Simple Values in the Debugger Console</a>
300
<li><a href="#Displaying%20Values">Displaying Complex Values in the Data Window</a>
301
<ul>
302
<li><a href="#Display%20Basics">Display Basics</a>
303
<ul>
304
<li><a href="#Creating%20Single%20Displays">Creating Single Displays</a>
305
<li><a href="#Selecting%20Displays">Selecting Displays</a>
306
<li><a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
307
<li><a href="#Rotating%20Displays">Rotating Displays</a>
308
<li><a href="#Displaying%20Local%20Variables">Displaying Local Variables</a>
309
<li><a href="#Displaying%20Program%20Status">Displaying Program Status</a>
310
<li><a href="#Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>
311
<li><a href="#Placement">Display Placement</a>
312
<li><a href="#Clustering">Clustering Displays</a>
313
<li><a href="#Creating%20Multiple%20Displays">Creating Multiple Displays</a>
314
<li><a href="#Editing%20all%20Displays">Editing all Displays</a>
315
<li><a href="#Deleting%20Displays">Deleting Displays</a>
316
</li></ul>
317
<li><a href="#Arrays">Arrays</a>
318
<ul>
319
<li><a href="#Array%20Slices">Array Slices</a>
320
<li><a href="#Repeated%20Values">Repeated Values</a>
321
<li><a href="#Arrays%20as%20Tables">Arrays as Tables</a>
322
</li></ul>
323
<li><a href="#Assignment">Assignment to Variables</a>
324
<li><a href="#Examining%20Structures">Examining Structures</a>
325
<ul>
326
<li><a href="#Dependent%20Values">Displaying Dependent Values</a>
327
<li><a href="#Dereferencing%20Pointers">Dereferencing Pointers</a>
328
<li><a href="#Shared%20Structures">Shared Structures</a>
329
<li><a href="#Display%20Shortcuts">Display Shortcuts</a>
330
</li></ul>
331
<li><a href="#Customizing%20Displays">Customizing Displays</a>
332
<ul>
333
<li><a href="#Using%20Data%20Themes">Using Data Themes</a>
334
<li><a href="#Applying%20Data%20Themes%20to%20Several%20Values">Applying Data Themes to Several Values</a>
335
<li><a href="#Editing%20Themes">Editing Themes</a>
336
<li><a href="#Writing%20Data%20Themes">Writing Data Themes</a>
337
<li><a href="#Display%20Resources">Display Resources</a>
338
<li><a href="#VSL%20Resources">VSL Resources</a>
339
</li></ul>
340
<li><a href="#Layouting%20the%20Graph">Layouting the Graph</a>
341
<ul>
342
<li><a href="#Moving%20Displays">Moving Displays</a>
343
<li><a href="#Scrolling%20Data">Scrolling Data</a>
344
<li><a href="#Aligning%20Displays">Aligning Displays</a>
345
<li><a href="#Automatic%20Layout">Automatic Layout</a>
346
<li><a href="#Rotating%20the%20Graph">Rotating the Graph</a>
347
</li></ul>
348
<li><a href="#Printing%20the%20Graph">Printing the Graph</a>
349
</li></ul>
350
<li><a href="#Plotting%20Values">Plotting Values</a>
351
<ul>
352
<li><a href="#Plotting%20Arrays">Plotting Arrays</a>
353
<li><a href="#Plot%20Appearance">Changing the Plot Appearance</a>
354
<li><a href="#Scalars%20and%20Composites">Plotting Scalars and Composites</a>
355
<li><a href="#Plotting%20Histories">Plotting Display Histories</a>
356
<li><a href="#Printing%20Plots">Printing Plots</a>
357
<li><a href="#Entering%20Plotting%20Commands">Entering Plotting Commands</a>
358
<li><a href="#Exporting%20Plot%20Data">Exporting Plot Data</a>
359
<li><a href="#Animating%20Plots">Animating Plots</a>
360
<li><a href="#Customizing%20Plots">Customizing Plots</a>
361
<ul>
362
<li><a href="#Gnuplot%20Invocation">Gnuplot Invocation</a>
363
<li><a href="#Gnuplot%20Settings">Gnuplot Settings</a>
364
</li></ul>
365
</li></ul>
366
<li><a href="#Examining%20Memory">Examining Memory</a>
367
</li></ul>
368
<li><a name="toc_Machine-Level%20Debugging" href="#Machine-Level%20Debugging">Machine-Level Debugging</a>
369
<ul>
370
<li><a href="#Machine%20Code">Examining Machine Code</a>
371
<li><a href="#Machine%20Code%20Execution">Machine Code Execution</a>
372
<li><a href="#Registers">Examining Registers</a>
373
<li><a href="#Customizing%20Machine%20Code">Customizing Machine Code</a>
374
</li></ul>
375
<li><a name="toc_Changing%20the%20Program" href="#Changing%20the%20Program">Changing the Program</a>
376
<ul>
377
<li><a href="#Editing%20Source%20Code">Editing Source Code</a>
378
<ul>
379
<li><a href="#Customizing%20Editing">Customizing Editing</a>
380
<li><a href="#In-Place%20Editing">In-Place Editing</a>
381
</li></ul>
382
<li><a href="#Recompiling">Recompiling</a>
383
<li><a href="#Patching">Patching</a>
384
</li></ul>
385
<li><a name="toc_Commands" href="#Commands">The Command-Line Interface</a>
386
<ul>
387
<li><a href="#Entering%20Commands">Entering Commands</a>
388
<ul>
389
<li><a href="#Command%20Completion">Command Completion</a>
390
<li><a href="#Command%20History">Command History</a>
391
<li><a href="#Typing%20in%20the%20Source%20Window">Typing in the Source Window</a>
392
</li></ul>
393
<li><a href="#TTY%20mode">Entering Commands at the TTY</a>
394
<li><a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating DDD</a>
395
<ul>
396
<li><a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Using DDD with Emacs</a>
397
<li><a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Using DDD with XEmacs</a>
398
<li><a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Using DDD with <small>XXGDB</small></a>
399
</li></ul>
400
<li><a href="#Defining%20Buttons">Defining Buttons</a>
401
<ul>
402
<li><a href="#Customizing%20Buttons">Customizing Buttons</a>
403
</li></ul>
404
<li><a href="#Defining%20Commands">Defining Commands</a>
405
<ul>
406
<li><a href="#GDB%20Simple%20Commands">Defining Simple Commands using GDB</a>
407
<li><a href="#GDB%20Argument%20Commands">Defining Argument Commands using GDB</a>
408
<li><a href="#Commands%20with%20Other%20Debuggers">Defining Commands using Other Debuggers</a>
409
</li></ul>
410
</li></ul>
411
<li><a name="toc_Application%20Defaults" href="#Application%20Defaults">Application Defaults</a>
412
<ul>
413
<li><a href="#Actions">Actions</a>
414
<ul>
415
<li><a href="#General%20Actions">General Actions</a>
416
<li><a href="#Data%20Display%20Actions">Data Display Actions</a>
417
<li><a href="#Debugger%20Console%20Actions">Debugger Console Actions</a>
418
<li><a href="#Source%20Window%20Actions">Source Window Actions</a>
419
</li></ul>
420
<li><a href="#Images">Images</a>
421
</li></ul>
422
<li><a name="toc_Bugs" href="#Bugs">Bugs and How To Report Them</a>
423
<ul>
424
<li><a href="#Where%20to%20Send%20Bug%20Reports">Where to Send Bug Reports</a>
425
<li><a href="#Is%20it%20a%20%3csmall%3eDDD%3c%2fsmall%3e%20Bug%3f">Is it a DDD Bug?</a>
426
<li><a href="#How%20to%20Report%20Bugs">How to Report Bugs</a>
427
<li><a href="#Bug%20Reports">What to Include in a Bug Report</a>
428
<li><a href="#Diagnostics">Getting Diagnostics</a>
429
<ul>
430
<li><a href="#Logging">Logging</a>
431
<ul>
432
<li><a href="#Disabling%20Logging">Disabling Logging</a>
433
</li></ul>
434
<li><a href="#Debugging%20%3csmall%3eDDD%3c%2fsmall%3e">Debugging DDD</a>
435
<li><a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
436
</li></ul>
437
</li></ul>
438
<li><a name="toc_Configuration%20Notes" href="#Configuration%20Notes">Configuration Notes</a>
439
<ul>
440
<li><a href="#GDB">Using DDD with GDB</a>
441
<ul>
442
<li><a href="#WDB">Using DDD with WDB</a>
443
<li><a href="#WindRiver%20GDB">Using DDD with WindRiver GDB (Tornado)</a>
444
</li></ul>
445
<li><a href="#DBX">Using DDD with DBX</a>
446
<li><a href="#Ladebug">Using DDD with Ladebug</a>
447
<li><a href="#XDB">Using DDD with XDB</a>
448
<li><a href="#JDB">Using DDD with JDB</a>
449
<li><a href="#Perl">Using DDD with Perl</a>
450
<li><a href="#Bash">Using DDD with Bash</a>
451
<li><a href="#LessTif">Using DDD with LessTif</a>
452
</li></ul>
453
<li><a name="toc_Dirty%20Tricks" href="#Dirty%20Tricks">Dirty Tricks</a>
454
<li><a name="toc_Extending" href="#Extending">Extending DDD</a>
455
<li><a name="toc_FAQ" href="#FAQ">Frequently Answered Questions</a>
456
<li><a name="toc_License" href="#License">GNU General Public License</a>
457
<ul>
458
<li><a href="#License">Preamble</a>
459
<li><a href="#License">How to Apply These Terms to Your New Programs</a>
460
</li></ul>
461
<li><a name="toc_Help%20and%20Assistance" href="#Help%20and%20Assistance">Help and Assistance</a>
462
<li><a name="toc_Documentation%20License" href="#Documentation%20License">GNU Free Documentation License</a>
463
<ul>
464
<li><a href="#Documentation%20License">ADDENDUM: How to use this License for your documents</a>
465
</li></ul>
466
<li><a name="toc_Label%20Index" href="#Label%20Index">Label Index</a>
467
<li><a name="toc_Key%20Index" href="#Key%20Index">Key Index</a>
468
<li><a name="toc_Command%20Index" href="#Command%20Index">Command Index</a>
469
<li><a name="toc_Resource%20Index" href="#Resource%20Index">Resource Index</a>
470
<li><a name="toc_File%20Index" href="#File%20Index">File Index</a>
471
<li><a name="toc_Concept%20Index" href="#Concept%20Index">Concept Index</a>
89
<li><a name="toc_Sample-Session" href="#Sample-Session">1 A Sample DDD Session</a>
90
<ul>
91
<li><a href="#Sample-Program">1.1 Sample Program</a>
92
</li></ul>
93
<li><a name="toc_Invocation" href="#Invocation">2 Getting In and Out of DDD</a>
94
<ul>
95
<li><a href="#Invoking">2.1 Invoking DDD</a>
96
<ul>
97
<li><a href="#Choosing-an-Inferior-Debugger">2.1.1 Choosing an Inferior Debugger</a>
98
<li><a href="#Options">2.1.2 DDD Options</a>
99
<li><a href="#X-Options">2.1.3 X Options</a>
100
<li><a href="#Inferior-Debugger-Options">2.1.4 Inferior Debugger Options</a>
101
<ul>
102
<li><a href="#GDB-Options">2.1.4.1 GDB Options</a>
103
<li><a href="#DBX-and-Ladebug-Options">2.1.4.2 DBX and Ladebug Options</a>
104
<li><a href="#XDB-Options">2.1.4.3 XDB Options</a>
105
<li><a href="#JDB-Options">2.1.4.4 JDB Options</a>
106
<li><a href="#Bash-Options">2.1.4.5 Bash Options</a>
107
<li><a href="#GNU-Make-Options">2.1.4.6 GNU Make Options</a>
108
<li><a href="#Perl-Options">2.1.4.7 Perl Options</a>
109
<li><a href="#PYDB-Options">2.1.4.8 PYDB Options</a>
110
</li></ul>
111
<li><a href="#Multiple-Instances">2.1.5 Multiple DDD Instances</a>
112
<li><a href="#X-Warnings">2.1.6 X warnings</a>
113
</li></ul>
114
<li><a href="#Quitting">2.2 Quitting DDD</a>
115
<li><a href="#Sessions">2.3 Persistent Sessions</a>
116
<ul>
117
<li><a href="#Saving-Sessions">2.3.1 Saving Sessions</a>
118
<li><a href="#Resuming-Sessions">2.3.2 Resuming Sessions</a>
119
<li><a href="#Deleting-Sessions">2.3.3 Deleting Sessions</a>
120
<li><a href="#Customizing-Sessions">2.3.4 Customizing Sessions</a>
121
</li></ul>
122
<li><a href="#Remote-Debugging">2.4 Remote Debugging</a>
123
<ul>
124
<li><a href="#Remote-Host">2.4.1 Running DDD on a Remote Host</a>
125
<li><a href="#Remote-Debugger">2.4.2 Using DDD with a Remote Inferior Debugger</a>
126
<ul>
127
<li><a href="#Customizing-Remote-Debugging">2.4.2.1 Customizing Remote Debugging</a>
128
</li></ul>
129
<li><a href="#Remote-Program">2.4.3 Debugging a Remote Program</a>
130
</li></ul>
131
<li><a href="#Customizing-Debugger-Interaction">2.5 Customizing Interaction with the Inferior Debugger</a>
132
<ul>
133
<li><a href="#Debugger-Invocation">2.5.1 Invoking an Inferior Debugger</a>
134
<li><a href="#Debugger-Initialization">2.5.2 Initializing the Inferior Debugger</a>
135
<ul>
136
<li><a href="#Bash-Initialization">2.5.2.1 Bash Initialization</a>
137
<li><a href="#DBX-Initialization">2.5.2.2 DBX Initialization</a>
138
<li><a href="#GDB-Initialization">2.5.2.3 GDB Initialization</a>
139
<li><a href="#JDB-Initialization">2.5.2.4 JDB Initialization</a>
140
<li><a href="#GNU-Make-Initialization">2.5.2.5 GNU Make Initialization</a>
141
<li><a href="#Perl-Initialization">2.5.2.6 Perl Initialization</a>
142
<li><a href="#PYDB-Initialization">2.5.2.7 PYDB Initialization</a>
143
<li><a href="#XDB-Initialization">2.5.2.8 XDB Initialization</a>
144
<li><a href="#Finding-a-Place-to-Start">2.5.2.9 Finding a Place to Start</a>
145
<li><a href="#Opening-the-Selection">2.5.2.10 Opening the Selection</a>
146
</li></ul>
147
<li><a href="#Debugger-Communication">2.5.3 Communication with the Inferior Debugger</a>
148
</li></ul>
149
</li></ul>
150
<li><a name="toc_Windows" href="#Windows">3 The DDD Windows</a>
151
<ul>
152
<li><a href="#Menu-Bar">3.1 The Menu Bar</a>
153
<ul>
154
<li><a href="#File-Menu">3.1.1 The File Menu</a>
155
<li><a href="#Edit-Menu">3.1.2 The Edit Menu</a>
156
<li><a href="#View-Menu">3.1.3 The View Menu</a>
157
<li><a href="#Program-Menu">3.1.4 The Program Menu</a>
158
<li><a href="#Commands-Menu">3.1.5 The Commands Menu</a>
159
<li><a href="#Status-Menu">3.1.6 The Status Menu</a>
160
<li><a href="#Source-Menu">3.1.7 The Source Menu</a>
161
<li><a href="#Data-Menu">3.1.8 The Data Menu</a>
162
<li><a href="#Maintenance-Menu">3.1.9 The Maintenance Menu</a>
163
<li><a href="#Help-Menu">3.1.10 The Help Menu</a>
164
<li><a href="#Customizing-the-Menu-Bar">3.1.11 Customizing the Menu Bar</a>
165
<ul>
166
<li><a href="#Auto_002dRaise-Menus">3.1.11.1 Auto-Raise Menus</a>
167
<li><a href="#Customizing-the-Edit-Menu">3.1.11.2 Customizing the Edit Menu</a>
168
</li></ul>
169
</li></ul>
170
<li><a href="#Tool-Bar">3.2 The Tool Bar</a>
171
<ul>
172
<li><a href="#Customizing-the-Tool-Bar">3.2.1 Customizing the Tool Bar</a>
173
</li></ul>
174
<li><a href="#Command-Tool">3.3 The Command Tool</a>
175
<ul>
176
<li><a href="#Customizing-the-Command-Tool">3.3.1 Customizing the Command Tool</a>
177
<ul>
178
<li><a href="#Disabling-the-Command-Tool">3.3.1.1 Disabling the Command Tool</a>
179
</li></ul>
180
<li><a href="#Customizing-Tool-Position">3.3.2 Command Tool Position</a>
181
<ul>
182
<li><a href="#Customizing-Tool-Decoration">3.3.2.1 Customizing Tool Decoration</a>
183
</li></ul>
184
</li></ul>
185
<li><a href="#Getting-Help">3.4 Getting Help</a>
186
<li><a href="#Undo-and-Redo">3.5 Undoing and Redoing Commands</a>
187
<li><a href="#Customizing">3.6 Customizing DDD</a>
188
<ul>
189
<li><a href="#How-Customizing-Works">3.6.1 How Customizing DDD Works</a>
190
<ul>
191
<li><a href="#Resources">3.6.1.1 Resources</a>
192
<li><a href="#Changing-Resources">3.6.1.2 Changing Resources</a>
193
<li><a href="#Saving-Options">3.6.1.3 Saving Options</a>
194
</li></ul>
195
<li><a href="#Customizing-Help">3.6.2 Customizing DDD Help</a>
196
<ul>
197
<li><a href="#Button-tips">3.6.2.1 Button Tips</a>
198
<li><a href="#Tip-of-the-day">3.6.2.2 Tip of the day</a>
199
<li><a href="#Help-Helpers">3.6.2.3 Help Helpers</a>
200
</li></ul>
201
<li><a href="#Customizing-Undo">3.6.3 Customizing Undo</a>
202
<li><a href="#Customizing-Windows">3.6.4 Customizing the DDD Windows</a>
203
<ul>
204
<li><a href="#Splash-Screen">3.6.4.1 Splash Screen</a>
205
<li><a href="#Window-Layout">3.6.4.2 Window Layout</a>
206
<li><a href="#Customizing-Fonts">3.6.4.3 Customizing Fonts</a>
207
<li><a href="#Toggling-Windows">3.6.4.4 Toggling Windows</a>
208
<li><a href="#Text-Fields">3.6.4.5 Text Fields</a>
209
<li><a href="#Icons">3.6.4.6 Icons</a>
210
<li><a href="#Adding-Buttons">3.6.4.7 Adding Buttons</a>
211
<li><a href="#More-Customizations">3.6.4.8 More Customizations</a>
212
</li></ul>
213
<li><a href="#Debugger-Settings">3.6.5 Debugger Settings</a>
214
</li></ul>
215
</li></ul>
216
<li><a name="toc_Navigating" href="#Navigating">4 Navigating through the Code</a>
217
<ul>
218
<li><a href="#Compiling-for-Debugging">4.1 Compiling for Debugging</a>
219
<li><a href="#Opening-Files">4.2 Opening Files</a>
220
<ul>
221
<li><a href="#Opening-Programs">4.2.1 Opening Programs</a>
222
<li><a href="#Opening-Core-Dumps">4.2.2 Opening Core Dumps</a>
223
<li><a href="#Opening-Source-Files">4.2.3 Opening Source Files</a>
224
<li><a href="#Filtering-Files">4.2.4 Filtering Files</a>
225
</li></ul>
226
<li><a href="#Looking-up-Items">4.3 Looking up Items</a>
227
<ul>
228
<li><a href="#Looking-up-Definitions">4.3.1 Looking up Definitions</a>
229
<li><a href="#Textual-Search">4.3.2 Textual Search</a>
230
<li><a href="#Looking-up-Previous-Locations">4.3.3 Looking up Previous Locations</a>
231
<li><a href="#Source-Path">4.3.4 Specifying Source Directories</a>
232
</li></ul>
233
<li><a href="#Customizing-Source">4.4 Customizing the Source Window</a>
234
<ul>
235
<li><a href="#Customizing-Glyphs">4.4.1 Customizing Glyphs</a>
236
<li><a href="#Customizing-Searching">4.4.2 Customizing Searching</a>
237
<li><a href="#Customizing-Source-Appearance">4.4.3 Customizing Source Appearance</a>
238
<li><a href="#Customizing-Source-Scrolling">4.4.4 Customizing Source Scrolling</a>
239
<li><a href="#Customizing-Source-Lookup">4.4.5 Customizing Source Lookup</a>
240
<li><a href="#Customizing-File-Filtering">4.4.6 Customizing File Filtering</a>
241
</li></ul>
242
</li></ul>
243
<li><a name="toc_Stopping" href="#Stopping">5 Stopping the Program</a>
244
<ul>
245
<li><a href="#Breakpoints">5.1 Breakpoints</a>
246
<ul>
247
<li><a href="#Setting-Breakpoints">5.1.1 Setting Breakpoints</a>
248
<ul>
249
<li><a href="#Setting-Breakpoints">5.1.1.1 Setting Breakpoints by Location</a>
250
<li><a href="#Setting-Breakpoints">5.1.1.2 Setting Breakpoints by Name</a>
251
<li><a href="#Setting-Breakpoints">5.1.1.3 Setting Regexp Breakpoints</a>
252
</li></ul>
253
<li><a href="#Deleting-Breakpoints">5.1.2 Deleting Breakpoints</a>
254
<li><a href="#Disabling-Breakpoints">5.1.3 Disabling Breakpoints</a>
255
<li><a href="#Temporary-Breakpoints">5.1.4 Temporary Breakpoints</a>
256
<li><a href="#Editing-Breakpoint-Properties">5.1.5 Editing Breakpoint Properties</a>
257
<li><a href="#Breakpoint-Conditions">5.1.6 Breakpoint Conditions</a>
258
<li><a href="#Breakpoint-Ignore-Counts">5.1.7 Breakpoint Ignore Counts</a>
259
<li><a href="#Breakpoint-Commands">5.1.8 Breakpoint Commands</a>
260
<li><a href="#Moving-and-Copying-Breakpoints">5.1.9 Moving and Copying Breakpoints</a>
261
<li><a href="#Looking-up-Breakpoints">5.1.10 Looking up Breakpoints</a>
262
<li><a href="#Editing-all-Breakpoints">5.1.11 Editing all Breakpoints</a>
263
<li><a href="#Hardware_002dAssisted-Breakpoints">5.1.12 Hardware-Assisted Breakpoints</a>
264
</li></ul>
265
<li><a href="#Watchpoints">5.2 Watchpoints</a>
266
<ul>
267
<li><a href="#Setting-Watchpoints">5.2.1 Setting Watchpoints</a>
268
<li><a href="#Editing-Watchpoint-Properties">5.2.2 Editing Watchpoint Properties</a>
269
<li><a href="#Editing-all-Watchpoints">5.2.3 Editing all Watchpoints</a>
270
<li><a href="#Deleting-Watchpoints">5.2.4 Deleting Watchpoints</a>
271
</li></ul>
272
<li><a href="#Interrupting">5.3 Interrupting</a>
273
<li><a href="#Stopping-X-Programs">5.4 Stopping X Programs</a>
274
<ul>
275
<li><a href="#Customizing-Grab-Checking">5.4.1 Customizing Grab Checking</a>
276
</li></ul>
277
</li></ul>
278
<li><a name="toc_Running" href="#Running">6 Running the Program</a>
279
<ul>
280
<li><a href="#Starting-Program-Execution">6.1 Starting Program Execution</a>
281
<ul>
282
<li><a href="#Arguments">6.1.1 Your Program's Arguments</a>
283
<li><a href="#Environment">6.1.2 Your Program's Environment</a>
284
<li><a href="#Working-Directory">6.1.3 Your Program's Working Directory</a>
285
<li><a href="#Input_002fOutput">6.1.4 Your Program's Input and Output</a>
286
</li></ul>
287
<li><a href="#Using-the-Execution-Window">6.2 Using the Execution Window</a>
288
<ul>
289
<li><a href="#Customizing-the-Execution-Window">6.2.1 Customizing the Execution Window</a>
290
</li></ul>
291
<li><a href="#Attaching-to-a-Process">6.3 Attaching to a Running Process</a>
292
<ul>
293
<li><a href="#Customizing-Attaching-to-Processes">6.3.1 Customizing Attaching to Processes</a>
294
</li></ul>
295
<li><a href="#Program-Stop">6.4 Program Stops</a>
296
<li><a href="#Resuming-Execution">6.5 Resuming Execution</a>
297
<ul>
298
<li><a href="#Resuming-Execution">6.5.1 Continuing</a>
299
<li><a href="#Resuming-Execution">6.5.2 Stepping one Line</a>
300
<li><a href="#Resuming-Execution">6.5.3 Continuing to the Next Line</a>
301
<li><a href="#Resuming-Execution">6.5.4 Continuing Until Here</a>
302
<li><a href="#Resuming-Execution">6.5.5 Continuing Until a Greater Line is Reached</a>
303
<li><a href="#Resuming-Execution">6.5.6 Continuing Until Function Returns</a>
304
</li></ul>
305
<li><a href="#Continuing-Somewhere-Else">6.6 Continuing at a Different Address</a>
306
<li><a href="#Stack">6.7 Examining the Stack</a>
307
<ul>
308
<li><a href="#Frames">6.7.1 Stack Frames</a>
309
<li><a href="#Backtraces">6.7.2 Backtraces</a>
310
<li><a href="#Selecting-a-frame">6.7.3 Selecting a Frame</a>
311
</li></ul>
312
<li><a href="#Undoing-Program-Execution">6.8 “Undoing” Program Execution</a>
313
<li><a href="#Threads">6.9 Examining Threads</a>
314
<li><a href="#Signals">6.10 Handling Signals</a>
315
<li><a href="#Killing-the-Program">6.11 Killing the Program</a>
316
</li></ul>
317
<li><a name="toc_Examining-Data" href="#Examining-Data">7 Examining Data</a>
318
<ul>
319
<li><a href="#Value-Tips">7.1 Showing Simple Values using Value Tips</a>
320
<li><a href="#Printing-Values">7.2 Printing Simple Values in the Debugger Console</a>
321
<li><a href="#Displaying-Values">7.3 Displaying Complex Values in the Data Window</a>
322
<ul>
323
<li><a href="#Display-Basics">7.3.1 Display Basics</a>
324
<ul>
325
<li><a href="#Creating-Single-Displays">7.3.1.1 Creating Single Displays</a>
326
<li><a href="#Selecting-Displays">7.3.1.2 Selecting Displays</a>
327
<li><a href="#Showing-and-Hiding-Details">7.3.1.3 Showing and Hiding Details</a>
328
<li><a href="#Rotating-Displays">7.3.1.4 Rotating Displays</a>
329
<li><a href="#Displaying-Local-Variables">7.3.1.5 Displaying Local Variables</a>
330
<li><a href="#Displaying-Program-Status">7.3.1.6 Displaying Program Status</a>
331
<li><a href="#Refreshing-the-Data-Window">7.3.1.7 Refreshing the Data Window</a>
332
<li><a href="#Placement">7.3.1.8 Display Placement</a>
333
<li><a href="#Clustering">7.3.1.9 Clustering Displays</a>
334
<li><a href="#Creating-Multiple-Displays">7.3.1.10 Creating Multiple Displays</a>
335
<li><a href="#Editing-all-Displays">7.3.1.11 Editing all Displays</a>
336
<li><a href="#Deleting-Displays">7.3.1.12 Deleting Displays</a>
337
</li></ul>
338
<li><a href="#Arrays">7.3.2 Arrays</a>
339
<ul>
340
<li><a href="#Array-Slices">7.3.2.1 Array Slices</a>
341
<li><a href="#Repeated-Values">7.3.2.2 Repeated Values</a>
342
<li><a href="#Arrays-as-Tables">7.3.2.3 Arrays as Tables</a>
343
</li></ul>
344
<li><a href="#Assignment">7.3.3 Assignment to Variables</a>
345
<li><a href="#Examining-Structures">7.3.4 Examining Structures</a>
346
<ul>
347
<li><a href="#Dependent-Values">7.3.4.1 Displaying Dependent Values</a>
348
<li><a href="#Dereferencing-Pointers">7.3.4.2 Dereferencing Pointers</a>
349
<li><a href="#Shared-Structures">7.3.4.3 Shared Structures</a>
350
<li><a href="#Display-Shortcuts">7.3.4.4 Display Shortcuts</a>
351
</li></ul>
352
<li><a href="#Customizing-Displays">7.3.5 Customizing Displays</a>
353
<ul>
354
<li><a href="#Using-Data-Themes">7.3.5.1 Using Data Themes</a>
355
<li><a href="#Applying-Data-Themes-to-Several-Values">7.3.5.2 Applying Data Themes to Several Values</a>
356
<li><a href="#Editing-Themes">7.3.5.3 Editing Themes</a>
357
<li><a href="#Writing-Data-Themes">7.3.5.4 Writing Data Themes</a>
358
<li><a href="#Display-Resources">7.3.5.5 Display Resources</a>
359
<li><a href="#VSL-Resources">7.3.5.6 VSL Resources</a>
360
</li></ul>
361
<li><a href="#Layouting-the-Graph">7.3.6 Layouting the Graph</a>
362
<ul>
363
<li><a href="#Moving-Displays">7.3.6.1 Moving Displays</a>
364
<li><a href="#Scrolling-Data">7.3.6.2 Scrolling Data</a>
365
<li><a href="#Aligning-Displays">7.3.6.3 Aligning Displays</a>
366
<li><a href="#Automatic-Layout">7.3.6.4 Automatic Layout</a>
367
<li><a href="#Rotating-the-Graph">7.3.6.5 Rotating the Graph</a>
368
</li></ul>
369
<li><a href="#Printing-the-Graph">7.3.7 Printing the Graph</a>
370
</li></ul>
371
<li><a href="#Plotting-Values">7.4 Plotting Values</a>
372
<ul>
373
<li><a href="#Plotting-Arrays">7.4.1 Plotting Arrays</a>
374
<li><a href="#Plot-Appearance">7.4.2 Changing the Plot Appearance</a>
375
<li><a href="#Scalars-and-Composites">7.4.3 Plotting Scalars and Composites</a>
376
<li><a href="#Plotting-Histories">7.4.4 Plotting Display Histories</a>
377
<li><a href="#Printing-Plots">7.4.5 Printing Plots</a>
378
<li><a href="#Entering-Plotting-Commands">7.4.6 Entering Plotting Commands</a>
379
<li><a href="#Exporting-Plot-Data">7.4.7 Exporting Plot Data</a>
380
<li><a href="#Animating-Plots">7.4.8 Animating Plots</a>
381
<li><a href="#Customizing-Plots">7.4.9 Customizing Plots</a>
382
<ul>
383
<li><a href="#Gnuplot-Invocation">7.4.9.1 Gnuplot Invocation</a>
384
<li><a href="#Gnuplot-Settings">7.4.9.2 Gnuplot Settings</a>
385
</li></ul>
386
</li></ul>
387
<li><a href="#Examining-Memory">7.5 Examining Memory</a>
388
</li></ul>
389
<li><a name="toc_Machine_002dLevel-Debugging" href="#Machine_002dLevel-Debugging">8 Machine-Level Debugging</a>
390
<ul>
391
<li><a href="#Machine-Code">8.1 Examining Machine Code</a>
392
<li><a href="#Machine-Code-Execution">8.2 Machine Code Execution</a>
393
<li><a href="#Registers">8.3 Examining Registers</a>
394
<li><a href="#Customizing-Machine-Code">8.4 Customizing Machine Code</a>
395
</li></ul>
396
<li><a name="toc_Changing-the-Program" href="#Changing-the-Program">9 Changing the Program</a>
397
<ul>
398
<li><a href="#Editing-Source-Code">9.1 Editing Source Code</a>
399
<ul>
400
<li><a href="#Customizing-Editing">9.1.1 Customizing Editing</a>
401
<li><a href="#In_002dPlace-Editing">9.1.2 In-Place Editing</a>
402
</li></ul>
403
<li><a href="#Recompiling">9.2 Recompiling</a>
404
<li><a href="#Patching">9.3 Patching</a>
405
</li></ul>
406
<li><a name="toc_Commands" href="#Commands">10 The Command-Line Interface</a>
407
<ul>
408
<li><a href="#Entering-Commands">10.1 Entering Commands</a>
409
<ul>
410
<li><a href="#Command-Completion">10.1.1 Command Completion</a>
411
<li><a href="#Command-History">10.1.2 Command History</a>
412
<li><a href="#Typing-in-the-Source-Window">10.1.3 Typing in the Source Window</a>
413
</li></ul>
414
<li><a href="#TTY-mode">10.2 Entering Commands at the TTY</a>
415
<li><a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">10.3 Integrating DDD</a>
416
<ul>
417
<li><a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">10.3.1 Using DDD with Emacs</a>
418
<li><a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">10.3.2 Using DDD with XEmacs</a>
419
<li><a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">10.3.3 Using DDD with <acronym>XXGDB</acronym></a>
420
</li></ul>
421
<li><a href="#Defining-Buttons">10.4 Defining Buttons</a>
422
<ul>
423
<li><a href="#Customizing-Buttons">10.4.1 Customizing Buttons</a>
424
</li></ul>
425
<li><a href="#Defining-Commands">10.5 Defining Commands</a>
426
<ul>
427
<li><a href="#GDB-Simple-Commands">10.5.1 Defining Simple Commands using GDB</a>
428
<li><a href="#GDB-Argument-Commands">10.5.2 Defining Argument Commands using GDB</a>
429
<li><a href="#Commands-with-Other-Debuggers">10.5.3 Defining Commands using Other Debuggers</a>
430
</li></ul>
431
</li></ul>
432
<li><a name="toc_Application-Defaults" href="#Application-Defaults">Appendix A Application Defaults</a>
433
<ul>
434
<li><a href="#Actions">A.1 Actions</a>
435
<ul>
436
<li><a href="#General-Actions">A.1.1 General Actions</a>
437
<li><a href="#Data-Display-Actions">A.1.2 Data Display Actions</a>
438
<li><a href="#Debugger-Console-Actions">A.1.3 Debugger Console Actions</a>
439
<li><a href="#Source-Window-Actions">A.1.4 Source Window Actions</a>
440
</li></ul>
441
<li><a href="#Images">A.2 Images</a>
442
</li></ul>
443
<li><a name="toc_Bugs" href="#Bugs">Appendix B Bugs and How To Report Them</a>
444
<ul>
445
<li><a href="#Where-to-Send-Bug-Reports">B.1 Where to Send Bug Reports</a>
446
<li><a href="#Is-it-a-_003cacronym_003eDDD_003c_002facronym_003e-Bug_003f">B.2 Is it a DDD Bug?</a>
447
<li><a href="#How-to-Report-Bugs">B.3 How to Report Bugs</a>
448
<li><a href="#Bug-Reports">B.4 What to Include in a Bug Report</a>
449
<li><a href="#Diagnostics">B.5 Getting Diagnostics</a>
450
<ul>
451
<li><a href="#Logging">B.5.1 Logging</a>
452
<ul>
453
<li><a href="#Disabling-Logging">B.5.1.1 Disabling Logging</a>
454
</li></ul>
455
<li><a href="#Debugging-_003cacronym_003eDDD_003c_002facronym_003e">B.5.2 Debugging DDD</a>
456
<li><a href="#Customizing-Diagnostics">B.5.3 Customizing Diagnostics</a>
457
</li></ul>
458
</li></ul>
459
<li><a name="toc_Configuration-Notes" href="#Configuration-Notes">Appendix C Configuration Notes</a>
460
<ul>
461
<li><a href="#GDB">C.1 Using DDD with GDB</a>
462
<ul>
463
<li><a href="#WDB">C.1.1 Using DDD with WDB</a>
464
<li><a href="#WindRiver-GDB">C.1.2 Using DDD with WindRiver GDB (Tornado)</a>
465
</li></ul>
466
<li><a href="#Bash">C.2 Using DDD with Bash</a>
467
<li><a href="#DBX">C.3 Using DDD with DBX</a>
468
<li><a href="#Ladebug">C.4 Using DDD with Ladebug</a>
469
<li><a href="#JDB">C.5 Using DDD with JDB</a>
470
<li><a href="#Make">C.6 Using DDD with GNU Make</a>
471
<li><a href="#Perl">C.7 Using DDD with Perl</a>
472
<li><a href="#Python">C.8 Using DDD with Python</a>
473
<li><a href="#XDB">C.9 Using DDD with XDB</a>
474
<li><a href="#LessTif">C.10 Using DDD with LessTif</a>
475
</li></ul>
476
<li><a name="toc_Dirty-Tricks" href="#Dirty-Tricks">Appendix D Dirty Tricks</a>
477
<li><a name="toc_Extending" href="#Extending">Appendix E Extending DDD</a>
478
<li><a name="toc_FAQ" href="#FAQ">Appendix F Frequently Answered Questions</a>
479
<li><a name="toc_License" href="#License">Appendix G GNU General Public License</a>
480
<li><a name="toc_Help-and-Assistance" href="#Help-and-Assistance">Appendix H Help and Assistance</a>
481
<li><a name="toc_Documentation-License" href="#Documentation-License">Appendix I GNU Free Documentation License</a>
482
<ul>
483
<li><a href="#Documentation-License">ADDENDUM: How to use this License for your documents</a>
484
</li></ul>
485
<li><a name="toc_Label-Index" href="#Label-Index">Label Index</a>
486
<li><a name="toc_Key-Index" href="#Key-Index">Key Index</a>
487
<li><a name="toc_Command-Index" href="#Command-Index">Command Index</a>
488
<li><a name="toc_Resource-Index" href="#Resource-Index">Resource Index</a>
489
<li><a name="toc_File-Index" href="#File-Index">File Index</a>
490
<li><a name="toc_Concept-Index" href="#Concept-Index">Concept Index</a>
472
491
</li></ul>
473
492
</div>
474
493
475
<p>Copyright © 2004 Universit�t des Saarlandes <br>
494
<!-- This section comes below the summary in the HTML file. -->
495
<p class="noindent">
496
<p>Copyright © 2004 Universit�t des Saarlandes <br>
476
497
Lehrstuhl Softwaretechnik <br>
477
498
Postfach 15 11 50 <br>
478
499
66041 Saarbr�cken <br>
479
500
GERMANY
480
501
481
<p>Distributed by <br>
502
<p class="noindent">Distributed by <br>
482
503
Free Software Foundation, Inc. <br>
483
504
59 Temple Place - Suite 330 <br>
484
505
Boston, MA 02111-1307 <br>
485
506
USA
486
507
487
<p><small>DDD</small> and this manual are available via
488
<a href="http://www.gnu.org/software/ddd/">the <small>DDD</small> <small>WWW</small> page</a>.
508
<p class="noindent"><acronym>DDD</acronym> and this manual are available via
509
<a href="http://www.gnu.org/software/ddd/">the <acronym>DDD</acronym> <acronym>WWW</acronym> page</a>.
489
510
490
511
<p>Permission is granted to copy, distribute and/or modify this document
491
512
under the terms of the GNU Free Documentation License, Version 1.1 or
492
513
any later version published by the Free Software Foundation; with no
493
514
Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. A
494
copy of the license is included in the section entitled "GNU Free
495
Documentation License"; See <a href="#Documentation%20License">Documentation License</a>, for details.
515
copy of the license is included in the section entitled “GNU Free
516
Documentation License”; See <a href="#Documentation-License">Documentation License</a>, for details.
496
517
497
518
<p>Send questions, comments, suggestions, etc. to <a href="mailto:ddd@gnu.org">ddd@gnu.org</a>. <br>
498
Send bug reports to <a href="mailto:bug-ddd@gnu.org">bug-ddd@gnu.org</a>. <br>
519
Submit bug reports at <a href="http://savannah.gnu.org/bugs/?group=ddd">http://savannah.gnu.org/bugs/?group=ddd</a>,
520
the <acronym>DDD</acronym> bug tracker. Incoming bug reports are automatically copied
521
to the developers' mailing list <a href="mailto:bug-ddd@gnu.org">bug-ddd@gnu.org</a>. <br>
499
522
523
<!-- The actual content starts here. -->
524
<!-- No idea why this `@node' requires all links. -->
500
525
<div class="node">
501
526
<p><hr>
502
<small class=header>
503
Node:<a name="Summary">Summary</a>,
504
Next:<a rel="next" accesskey="n" href="#Sample%20Session">Sample Session</a>,
505
Previous:<a rel="previous" accesskey="p" href="#Top">Top</a>,
506
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
527
<a name="Summary"></a>
528
Next: <a rel="next" accesskey="n" href="#Sample-Session">Sample Session</a>,
529
Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>,
530
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
507
531
</small>
508
532
509
<br>
533
510
534
</div>
511
535
512
536
<h2 class="unnumbered">Summary of DDD</h2>
513
537
514
<p>The purpose of a debugger such as <small>DDD</small> is to allow you to see
515
what is going on "inside" another program while it executes--or what
538
<p>The purpose of a debugger such as <acronym>DDD</acronym> is to allow you to see
539
what is going on “inside” another program while it executes—or what
516
540
another program was doing at the moment it crashed.
517
541
518
<p><small>DDD</small> can do four main kinds of things (plus other things in
542
<p><acronym>DDD</acronym> can do four main kinds of things (plus other things in
519
543
support of these) to help you catch bugs in the act:
520
544
521
545
<ul>
526
550
effects of one bug and go on to learn about another.
527
551
</ul>
528
552
529
<p>Technically speaking, <small>DDD</small> is a front-end to a command-line
553
<p><a name="index-Inferior-debugger-1"></a><a name="index-Command_002dline-debugger-2"></a>Technically speaking, <acronym>DDD</acronym> is a front-end to a command-line
530
554
debugger (called <dfn>inferior debugger</dfn>, because it lies at the layer
531
beneath <small>DDD</small>). <small>DDD</small> supports the following inferior
555
beneath <acronym>DDD</acronym>). <acronym>DDD</acronym> supports the following inferior
532
556
debuggers:
533
557
534
558
<ul>
535
<li>To debug <em>executable binaries</em>, you can use <small>DDD</small> with <dfn></dfn><small>GDB</small><dfn></dfn>,
536
<dfn></dfn><small>DBX</small><dfn></dfn>, <dfn>Ladebug</dfn>, or <dfn></dfn><small>XDB</small><dfn></dfn>.
559
<li>To debug <em>executable binaries</em>, you can use <acronym>DDD</acronym> with <dfn><acronym>GDB</acronym></dfn>,
560
<dfn><acronym>DBX</acronym></dfn>, <dfn>Ladebug</dfn>, or <dfn><acronym>XDB</acronym></dfn>.
537
561
538
562
<ul>
539
<li><dfn></dfn><small>GDB</small><dfn></dfn>, the <small>GNU</small> debugger, is the recommended inferior debugger
540
for <small>DDD</small>. <small>GDB</small> supports native executables binaries originally
563
<li><a name="index-g_t_0040acronym_007bGDB_007d-3"></a><a name="index-C-4"></a><a name="index-C_002b_002b-5"></a><a name="index-Modula_002d2-6"></a><a name="index-Modula_002d3-7"></a><a name="index-Pascal-8"></a><a name="index-Chill-9"></a><a name="index-Ada-10"></a><a name="index-FORTRAN-11"></a><dfn><acronym>GDB</acronym></dfn>, the <acronym>GNU</acronym> debugger, is the recommended inferior debugger
564
for <acronym>DDD</acronym>. <acronym>GDB</acronym> supports native executables binaries originally
541
565
written in C, C++, Java, Modula-2, Modula-3, Pascal, Chill, Ada, and
542
FORTRAN. (see <a href="gdb.html#Languages">Using <small>GDB</small> with Different Languages</a>, for
543
information on language support in <small>GDB</small>.)
566
FORTRAN. (see <a href="gdb.html#Languages">Using <acronym>GDB</acronym> with Different Languages</a>, for
567
information on language support in <acronym>GDB</acronym>.)
544
568
545
<li>As an alternative to <small>GDB</small>, you can use <small>DDD</small> with the <dfn></dfn><small>DBX</small><dfn></dfn>
546
debugger, as found on several <small>UNIX</small> systems. Most <small>DBX</small> incarnations offer
547
fewer features than <small>GDB</small>, and some of the more advanced <small>DBX</small> features may
548
not be supported by <small>DDD</small>. However, using <small>DBX</small> may be useful if
549
<small>GDB</small> does not understand or fully support the debugging information as
569
<li><a name="index-g_t_0040acronym_007bDBX_007d-12"></a>As an alternative to <acronym>GDB</acronym>, you can use <acronym>DDD</acronym> with the <dfn><acronym>DBX</acronym></dfn>
570
debugger, as found on several <acronym>UNIX</acronym> systems. Most <acronym>DBX</acronym> incarnations offer
571
fewer features than <acronym>GDB</acronym>, and some of the more advanced <acronym>DBX</acronym> features may
572
not be supported by <acronym>DDD</acronym>. However, using <acronym>DBX</acronym> may be useful if
573
<acronym>GDB</acronym> does not understand or fully support the debugging information as
550
574
generated by your compiler.
551
575
552
<li>As an alternative to <small>GDB</small> and <small>DBX</small>, you can use <small>DDD</small> with
576
<li><a name="index-Ladebug-13"></a>As an alternative to <acronym>GDB</acronym> and <acronym>DBX</acronym>, you can use <acronym>DDD</acronym> with
553
577
<dfn>Ladebug</dfn>, as found on Compaq and DEC systems. Ladebug offers fewer
554
features than <small>GDB</small>, and some of the more advanced Ladebug features may
555
not be supported by <small>DDD</small>. However, using Ladebug may be useful if
556
<small>GDB</small> or <small>DBX</small> do not understand or fully support the debugging
557
information as generated by your compiler.<a rel="footnote" href="#fn-1"><sup>1</sup></a>
578
features than <acronym>GDB</acronym>, and some of the more advanced Ladebug features may
579
not be supported by <acronym>DDD</acronym>. However, using Ladebug may be useful if
580
<acronym>GDB</acronym> or <acronym>DBX</acronym> do not understand or fully support the debugging
581
information as generated by your compiler.<a rel="footnote" href="#fn-1" name="fnd-1"><sup>1</sup></a>
558
582
559
<li>As another alternative to <small>GDB</small>, you can use <small>DDD</small> with the
560
<dfn></dfn><small>XDB</small><dfn></dfn> debugger, as found on <small>HP-UX</small>
561
systems.<a rel="footnote" href="#fn-2"><sup>2</sup></a>.
583
<li><a name="index-g_t_0040acronym_007bXDB_007d-14"></a>As another alternative to <acronym>GDB</acronym>, you can use <acronym>DDD</acronym> with the
584
<dfn><acronym>XDB</acronym></dfn> debugger, as found on <acronym>HP-UX</acronym>
585
systems.<a rel="footnote" href="#fn-2" name="fnd-2"><sup>2</sup></a>.
562
586
</ul>
563
587
564
<li>To debug <em>Java byte code programs</em>, you can use <small>DDD</small> with
565
<dfn></dfn><small>JDB</small><dfn></dfn>, the Java debugger, as of <small>JDK</small> 1.1 and later.
566
(<small>DDD</small> has been tested with <small>JDK</small> 1.1 and <small>JDK</small> 1.2.)
567
568
<li>To debug <em>Python programs</em>, you can use <small>DDD</small> with
569
<dfn></dfn><small>PYDB</small><dfn></dfn>, a Python debugger.
570
571
<li>To debug <em>Perl programs</em>, you can use <small>DDD</small> with the <dfn>Perl
588
<li><a name="index-g_t_0040acronym_007bJDB_007d-15"></a><a name="index-Java-16"></a>To debug <em>Java byte code programs</em>, you can use <acronym>DDD</acronym> with
589
<dfn><acronym>JDB</acronym></dfn>, the Java debugger, as of <acronym>JDK</acronym> 1.1 and later.
590
(<acronym>DDD</acronym> has been tested with <acronym>JDK</acronym> 1.1 and <acronym>JDK</acronym> 1.2.)
591
592
<li><li><a name="index-Bash-17"></a>To debug <em>Bash programs</em>, you need a version Bash that supports
593
extended debugging support; see
594
<a href="http://bashdb.sourceforge.net">http://bashdb.sourceforge.net</a>. It important to make sure you
595
get the right version of the debugger that matches your version of
596
Bash. For bash version 2.05b, you need a patched version of bash as
597
well as the debugger for bash.
598
599
<li><a name="index-GNU-Make-18"></a>To debug <em>GNU Make Makefiles</em>, you need a version GNU Make that supports
600
extended debugging support. To get this enhanced version see
601
<a href="http://bashdb.sourceforge.net/remake">http://bashdb.sourceforge.net/remake</a>.
602
603
<li><a name="index-Perl-19"></a>To debug <em>Perl programs</em>, you can use <acronym>DDD</acronym> with the <dfn>Perl
572
604
debugger,</dfn> as of Perl 5.003 and later.
573
605
574
<li>To debug <em>Bash programs</em>, you need a version Bash that supports
575
extended debugging support. To get this enhanced version see
576
<a href="http://bashdb.sourceforge.net">http://bashdb.sourceforge.net</a>. You will need version
577
2.05b-debugger-0.32 or later to work with <small>DDD</small>.
606
<li><a name="index-Python-20"></a><a name="index-pydb-21"></a>
607
To debug <em>Python programs</em>, you need an extended version of the
608
python debugger called <code>pydb</code>. To get this, see
609
<a href="http://bashdb.sourceforge.net/pydb">http://bashdb.sourceforge.net/pydb</a>.
578
610
</ul>
579
611
580
<p>See <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>, for choosing the appropriate
581
inferior debugger. See <a href="#Sample%20Session">Sample Session</a>, for getting a first
582
impression of <small>DDD</small>.
612
<p>See <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a>, for choosing the appropriate
613
inferior debugger. See <a href="#Sample-Session">Sample Session</a>, for getting a first
614
impression of <acronym>DDD</acronym>.
583
615
584
616
<ul class="menu">
585
<li><a accesskey="1" href="#About%20this%20Manual">About this Manual</a>: Getting copies in various formats.
586
<li><a accesskey="2" href="#Typographic%20Conventions">Typographic Conventions</a>: Typographic conventions.
587
<li><a accesskey="3" href="#Free%20Software">Free Software</a>: How to copy and redistribute <small>DDD</small>.
588
<li><a accesskey="4" href="#Getting%20%3csmall%3eDDD%3c%2fsmall%3e">Getting <small>DDD</small></a>: How to obtain copies of <small>DDD</small>.
617
<li><a accesskey="1" href="#About-this-Manual">About this Manual</a>: Getting copies in various formats.
618
<li><a accesskey="2" href="#Typographic-Conventions">Typographic Conventions</a>: Typographic conventions.
619
<li><a accesskey="3" href="#Free-Software">Free Software</a>: How to copy and redistribute <acronym>DDD</acronym>.
620
<li><a accesskey="4" href="#Getting-_003cacronym_003eDDD_003c_002facronym_003e">Getting <acronym>DDD</acronym></a>: How to obtain copies of <acronym>DDD</acronym>.
589
621
<li><a accesskey="5" href="#Contributors">Contributors</a>: Who has done all this?
590
<li><a accesskey="6" href="#History">History</a>: Old <small>DDD</small> versions.
622
<li><a accesskey="6" href="#History">History</a>: Old <acronym>DDD</acronym> versions.
591
623
</ul>
592
624
593
625
<div class="node">
594
626
<p><hr>
595
<small class=header>
596
Node:<a name="About%20this%20Manual">About this Manual</a>,
597
Next:<a rel="next" accesskey="n" href="#Typographic%20Conventions">Typographic Conventions</a>,
598
Up:<a rel="up" accesskey="u" href="#Summary">Summary</a>
627
<a name="About-this-Manual"></a>
628
Next: <a rel="next" accesskey="n" href="#Typographic-Conventions">Typographic Conventions</a>,
629
Up: <a rel="up" accesskey="u" href="#Summary">Summary</a>
599
630
</small>
600
631
601
<br>
632
602
633
</div>
603
634
604
635
<h3 class="unnumberedsec">About this Manual</h3>
605
636
606
<p>This manual comes in several formats:
637
<p>This manual comes in several formats:
607
638
608
639
<ul>
609
<li>The <em>Info</em> format is used for browsing on character devices; it
640
<li><a name="index-Info-manual-22"></a>The <em>Info</em> format is used for browsing on character devices; it
610
641
comes without pictures. You should have a local copy installed, which
611
you can browse via Emacs, the stand-alone <code>info</code> program, or from
612
<small>DDD</small> via <code>Help => </code><small>DDD</small><code> Reference</code>.
642
you can browse via Emacs, the stand-alone <samp><span class="command">info</span></samp> program, or from
643
<acronym>DDD</acronym> via ‘<samp><span class="samp">Help <acronym>DDD</acronym> Reference</span></samp>’.
613
644
614
<p>The <small>DDD</small> source distribution
615
<code>ddd-3.3.11.tar.gz</code> contains this manual as
645
<p><a name="index-ddd_002d_0040value_007bVERSION_007d_002etar_002egz-23"></a>The <acronym>DDD</acronym> source distribution
646
<samp><span class="file">ddd-3.3.12.tar.gz</span></samp> contains this manual as
616
647
pre-formatted info files; you can also download them from <br>
617
<a href="http://www.gnu.org/software/ddd/">the <small>DDD</small> <small>WWW</small> page</a>.
648
<a href="http://www.gnu.org/software/ddd/">the <acronym>DDD</acronym> <acronym>WWW</acronym> page</a>.
618
649
619
</p><li>The <em>PostScript</em> format is used for printing on paper; it comes
650
<li><a name="index-PostScript-manual-24"></a>The <em>PostScript</em> format is used for printing on paper; it comes
620
651
with pictures as well.
621
652
622
<p>The <small>DDD</small> source distribution
623
<code>ddd-3.3.11.tar.gz</code> contains this manual as
653
<p>The <acronym>DDD</acronym> source distribution
654
<samp><span class="file">ddd-3.3.12.tar.gz</span></samp> contains this manual as
624
655
pre-formatted PostScript file; you can also download it from <br>
625
<a href="http://www.gnu.org/software/ddd/">the <small>DDD</small> <small>WWW</small> page</a>.
656
<a href="http://www.gnu.org/software/ddd/">the <acronym>DDD</acronym> <acronym>WWW</acronym> page</a>.
626
657
627
</p><li>The <em>PDF</em> format is used for printing on paper as well as for
658
<li><a name="index-PDF-manual-25"></a>The <em>PDF</em> format is used for printing on paper as well as for
628
659
online browsing; it comes with pictures as well.
629
660
630
<p>The <small>DDD</small> source distribution
631
<code>ddd-3.3.11.tar.gz</code> contains this manual as
661
<p>The <acronym>DDD</acronym> source distribution
662
<samp><span class="file">ddd-3.3.12.tar.gz</span></samp> contains this manual as
632
663
pre-formatted PDF file; you can also download it from <br>
633
<a href="http://www.gnu.org/software/ddd/">the <small>DDD</small> <small>WWW</small> page</a>.
664
<a href="http://www.gnu.org/software/ddd/">the <acronym>DDD</acronym> <acronym>WWW</acronym> page</a>.
634
665
635
</p><li>The <em>HTML</em> format is used for browsing on bitmap devices; it
666
<li><a name="index-HTML-manual-26"></a>The <em>HTML</em> format is used for browsing on bitmap devices; it
636
667
includes several pictures. You can view it using a HTML browser,
637
668
typically from a local copy.
638
669
639
<p>A pre-formatted HTML version of this manual comes
640
in a separate <small>DDD</small> package <br>
641
<code>ddd-3.3.11-html-manual.tar.gz</code>; you can browse
670
<p><a name="index-ddd_002d_0040value_007bVERSION_007d_002dhtml_002dmanual_002etar_002egz-27"></a>A pre-formatted HTML version of this manual comes
671
in a separate <acronym>DDD</acronym> package <br>
672
<samp><span class="file">ddd-3.3.12-html-manual.tar.gz</span></samp>; you can browse
642
673
and download it via <br>
643
the <a href="http://www.gnu.org/software/ddd/"><small>DDD</small> <small>WWW</small> page</a>.
674
the <a href="http://www.gnu.org/software/ddd/"><acronym>DDD</acronym> <acronym>WWW</acronym> page</a>.
644
675
</ul>
645
676
646
<p>The manual itself is written in TeXinfo format; its source code
647
<code>ddd.texi</code> is contained in the <small>DDD</small> source distribution
648
<code>ddd-3.3.11.tar.gz</code>.
677
<p><a name="index-g_t_0040TeX_007b_007dinfo-manual-28"></a>The manual itself is written in TeXinfo format; its source code
678
<samp><span class="file">ddd.texi</span></samp> is contained in the <acronym>DDD</acronym> source distribution
679
<samp><span class="file">ddd-3.3.12.tar.gz</span></samp>.
649
680
650
<p>The picture sources come in a separate package
651
<code>ddd-3.3.11-pics.tar.gz</code>; you need this package
681
<p><a name="index-ddd_002d_0040value_007bVERSION_007d_002dpics_002etar_002egz-29"></a>The picture sources come in a separate package
682
<samp><span class="file">ddd-3.3.12-pics.tar.gz</span></samp>; you need this package
652
683
only if you want to re-create the PostScript, HTML, or PDF versions.
653
684
654
685
<div class="node">
655
686
<p><hr>
656
<small class=header>
657
Node:<a name="Typographic%20Conventions">Typographic Conventions</a>,
658
Next:<a rel="next" accesskey="n" href="#Free%20Software">Free Software</a>,
659
Previous:<a rel="previous" accesskey="p" href="#About%20this%20Manual">About this Manual</a>,
660
Up:<a rel="up" accesskey="u" href="#Summary">Summary</a>
687
<a name="Typographic-Conventions"></a>
688
Next: <a rel="next" accesskey="n" href="#Free-Software">Free Software</a>,
689
Previous: <a rel="previous" accesskey="p" href="#About-this-Manual">About this Manual</a>,
690
Up: <a rel="up" accesskey="u" href="#Summary">Summary</a>
661
691
</small>
662
692
663
<br>
693
664
694
</div>
665
695
666
696
<h3 class="unnumberedsec">Typographic conventions</h3>
667
697
668
698
<dl>
669
<dt><Ctrl+A>
670
<dd>The name for a key on the keyboard (or multiple keys pressed simultaneously)
671
672
<br><dt><kbd>run</kbd>
673
<dd>A sequence of characters to be typed on the keyboard.
674
675
<br><dt><code>~/.ddd/init</code>
676
<dd>A file.
677
678
<br><dt><code>Help</code>
679
<dd>A graphical control element, such as a button or menu item.
680
681
<br><dt><code>File => Open Program</code>
682
<dd>A sequence of menu items, starting at the top-level menu bar.
683
684
<br><dt><code>argc - 1</code>
685
<dd>Program code or debugger command.
686
687
<br><dt><code>-g</code>
688
<dd>A command-line option.
689
690
<br><dt><code>$</code>
691
<dd>System prompt.
692
693
<br><dt><code>(gdb) </code>
694
<dd>Debugger prompt.
695
696
<br><dt><code>_</code>
697
<dd>Cursor position.
698
699
<br><dt><var>version</var>
700
<dd>A metasyntactic variable; something that stands for another piece of
699
<dt><Ctrl+A><dd>The name for a key on the keyboard (or multiple keys pressed simultaneously)
700
701
<br><dt><kbd>run</kbd><dd>A sequence of characters to be typed on the keyboard.
702
703
<br><dt><samp><span class="file">~/.ddd/init</span></samp><dd>A file.
704
705
<br><dt>‘<samp><span class="samp">Help</span></samp>’<dd>A graphical control element, such as a button or menu item.
706
707
<br><dt>‘<samp><span class="samp">File Open Program</span></samp>’<dd>A sequence of menu items, starting at the top-level menu bar.
708
709
<br><dt><code>argc - 1</code><dd>Program code or debugger command.
710
711
<br><dt><samp><span class="option">-g</span></samp><dd>A command-line option.
712
713
<br><dt><code>$</code><dd>System prompt.
714
715
<br><dt><code>(gdb) </code><dd>Debugger prompt.
716
717
<br><dt><code>_</code><dd>Cursor position.
718
719
<br><dt><var>version</var><dd>A metasyntactic variable; something that stands for another piece of
701
720
text.
702
721
703
<br><dt><dfn>definition</dfn>
704
<dd>A definition.
705
706
<br><dt><em>caution</em>
707
<dd>Emphasis.
708
709
<br><dt><strong>A warning</strong>
710
<dd>Strong emphasis.
711
712
<br><dt><small>DDD</small>
713
<dd>An acronym.
722
<br><dt><dfn>definition</dfn><dd>A definition.
723
724
<br><dt><em>caution</em><dd>Emphasis.
725
726
<br><dt><strong>A warning</strong><dd>Strong emphasis.
727
728
<br><dt><acronym>DDD</acronym><dd>An acronym.
714
729
</dl>
715
730
716
<p>Here's an example. <code></code><kbd>break </kbd><var>location</var><kbd></kbd><code></code> is a typed command
717
at the <code>(gdb) </code> prompt; the metasyntactic variable
718
<code></code><var>location</var><code></code> would be replaced by the actual location.
719
<code>_</code> is the cursor position after entering the command.
731
<p>Here's an example. ‘<samp><kbd>break </kbd><var>location</var></samp>’ is a typed command
732
at the ‘<samp><code>(gdb) </code></samp>’ prompt; the metasyntactic variable
733
‘<samp><var>location</var></samp>’ would be replaced by the actual location.
734
‘<samp><code>_</code></samp>’ is the cursor position after entering the command.
720
735
721
<pre class="example"> (gdb) <kbd>break </kbd><var>location</var><kbd></kbd>
736
<pre class="example"> (gdb) <kbd>break </kbd><var>location</var>
722
737
Breakpoint <var>number</var> at <var>location</var>
723
738
(gdb) _
724
</pre>
725
726
<div class="node">
739
</pre>
740
<div class="node">
727
741
<p><hr>
728
<small class=header>
729
Node:<a name="Free%20Software">Free Software</a>,
730
Next:<a rel="next" accesskey="n" href="#Getting%20%3csmall%3eDDD%3c%2fsmall%3e">Getting <small>DDD</small></a>,
731
Previous:<a rel="previous" accesskey="p" href="#Typographic%20Conventions">Typographic Conventions</a>,
732
Up:<a rel="up" accesskey="u" href="#Summary">Summary</a>
742
<a name="Free-Software"></a>
743
Next: <a rel="next" accesskey="n" href="#Getting-_003cacronym_003eDDD_003c_002facronym_003e">Getting <acronym>DDD</acronym></a>,
744
Previous: <a rel="previous" accesskey="p" href="#Typographic-Conventions">Typographic Conventions</a>,
745
Up: <a rel="up" accesskey="u" href="#Summary">Summary</a>
733
746
</small>
734
747
735
<br>
748
736
749
</div>
737
750
738
751
<h3 class="unnumberedsec">Free software</h3>
739
752
740
<p><small>DDD</small> is <dfn>free</dfn>; this means that everyone is free to use it and
741
free to redistribute it on a free basis. <small>DDD</small> is not in the public
753
<p><a name="index-License-30"></a><a name="index-GPL-31"></a><acronym>DDD</acronym> is <dfn>free</dfn>; this means that everyone is free to use it and
754
free to redistribute it on a free basis. <acronym>DDD</acronym> is not in the public
742
755
domain; it is copyrighted and there are restrictions on its
743
756
distribution, but these restrictions are designed to permit everything
744
757
that a good cooperating citizen would want to do. What is not allowed
745
is to try to prevent others from further sharing any version of <small>DDD</small>
758
is to try to prevent others from further sharing any version of <acronym>DDD</acronym>
746
759
that they might get from you. The precise conditions are found in the
747
<small>GNU</small> General Public License that comes with <small>DDD</small>; See <a href="#License">License</a>,
760
<acronym>GNU</acronym> General Public License that comes with <acronym>DDD</acronym>; See <a href="#License">License</a>,
748
761
for details.
749
762
750
<p>The easiest way to get a copy of <small>DDD</small> is from someone else who
763
<p>The easiest way to get a copy of <acronym>DDD</acronym> is from someone else who
751
764
has it. You need not ask for permission to do so, or tell any one else;
752
765
just copy it.
753
766
754
767
<div class="node">
755
768
<p><hr>
756
<small class=header>
757
Node:<a name="Getting%20%3csmall%3eDDD%3c%2fsmall%3e">Getting <small>DDD</small></a>,
758
Next:<a rel="next" accesskey="n" href="#Contributors">Contributors</a>,
759
Previous:<a rel="previous" accesskey="p" href="#Free%20Software">Free Software</a>,
760
Up:<a rel="up" accesskey="u" href="#Summary">Summary</a>
769
<a name="Getting-%3cacronym%3eDDD%3c%2facronym%3e"></a>
770
<a name="Getting-_003cacronym_003eDDD_003c_002facronym_003e"></a>
771
Next: <a rel="next" accesskey="n" href="#Contributors">Contributors</a>,
772
Previous: <a rel="previous" accesskey="p" href="#Free-Software">Free Software</a>,
773
Up: <a rel="up" accesskey="u" href="#Summary">Summary</a>
761
774
</small>
762
775
763
<br>
776
764
777
</div>
765
778
766
779
<h3 class="unnumberedsec">Getting DDD</h3>
767
780
768
<p>If you have access to the Internet, you can get the latest version of
769
<small>DDD</small> from the anonymous <small>FTP</small> server <code>ftp.gnu.org</code> in the
770
directory <code>/gnu/ddd</code>. This should contain the following files:
781
<p>If you have access to the Internet, you can get the latest version of
782
<acronym>DDD</acronym> from the anonymous <acronym>FTP</acronym> server ‘<samp><span class="samp">ftp.gnu.org</span></samp>’ in the
783
directory <samp><span class="file">/gnu/ddd</span></samp>. This should contain the following files:
771
784
772
785
<dl>
773
<dt><code>ddd-</code><var>version</var><code>.tar.gz</code>
774
<dd>The <small>DDD</small> source distribution. This should be all you need.
775
776
<br><dt><code>ddd-</code><var>version</var><code>-html-manual.tar.gz</code>
777
<dd>The <small>DDD</small> manual in HTML format. You need this only if you want to
778
install a local copy of the <small>DDD</small> manual in HTML format.
779
780
<br><dt><code>ddd-</code><var>version</var><code>-pics.tar.gz</code>
781
<dd>Sources of images included in the <small>DDD</small> manual. You need this
782
only if you want to recreate the <small>DDD</small> manual.
786
<dt><samp><samp><span class="file">ddd-</span><var>version</var><span class="file">.tar.gz</span></samp></samp><dd><a name="index-ddd_002d_0040var_007bversion_007d_002etar_002egz-32"></a>The <acronym>DDD</acronym> source distribution. This should be all you need.
787
788
<br><dt><samp><samp><span class="file">ddd-</span><var>version</var><span class="file">-html-manual.tar.gz</span></samp></samp><dd><a name="index-ddd_002d_0040var_007bversion_007d_002dhtml_002dmanual_002etar_002egz-33"></a>The <acronym>DDD</acronym> manual in HTML format. You need this only if you want to
789
install a local copy of the <acronym>DDD</acronym> manual in HTML format.
790
791
<br><dt><samp><samp><span class="file">ddd-</span><var>version</var><span class="file">-pics.tar.gz</span></samp></samp><dd><a name="index-ddd_002d_0040var_007bversion_007d_002dpics_002etar_002egz-34"></a>Sources of images included in the <acronym>DDD</acronym> manual. You need this
792
only if you want to recreate the <acronym>DDD</acronym> manual.
783
793
</dl>
784
794
785
<p><small>DDD</small> can also be found at numerous other archive sites around the
786
world; check the file <code>ANNOUNCE</code> in a <small>DDD</small> distribution for
795
<p><acronym>DDD</acronym> can also be found at numerous other archive sites around the
796
world; check the file <samp><span class="file">ANNOUNCE</span></samp> in a <acronym>DDD</acronym> distribution for
787
797
the latest known list.
788
798
789
799
<div class="node">
790
800
<p><hr>
791
<small class=header>
792
Node:<a name="Contributors">Contributors</a>,
793
Next:<a rel="next" accesskey="n" href="#History">History</a>,
794
Previous:<a rel="previous" accesskey="p" href="#Getting%20%3csmall%3eDDD%3c%2fsmall%3e">Getting <small>DDD</small></a>,
795
Up:<a rel="up" accesskey="u" href="#Summary">Summary</a>
801
<a name="Contributors"></a>
802
Next: <a rel="next" accesskey="n" href="#History">History</a>,
803
Previous: <a rel="previous" accesskey="p" href="#Getting-_003cacronym_003eDDD_003c_002facronym_003e">Getting <acronym>DDD</acronym></a>,
804
Up: <a rel="up" accesskey="u" href="#Summary">Summary</a>
796
805
</small>
797
806
798
<br>
807
799
808
</div>
800
809
801
810
<h3 class="unnumberedsec">Contributors to DDD</h3>
802
811
803
<p>Dorothea L�tkehaus and Andreas Zeller were the original authors of
804
<small>DDD</small>. Many others have contributed to its development. The
805
files <code>ChangeLog</code> and <code>THANKS</code> in the <small>DDD</small> distribution
812
<p><a name="index-Contributors-35"></a>
813
<a name="index-Zeller_002c-Andreas-36"></a><a name="index-L_00fctkehaus_002c-Dorothea-37"></a><a name="index-ChangeLog-38"></a><a name="index-TODO-39"></a>Dorothea L�tkehaus and Andreas Zeller were the original authors of
814
<acronym>DDD</acronym>. Many others have contributed to its development. The
815
files <samp><span class="file">ChangeLog</span></samp> and <samp><span class="file">THANKS</span></samp> in the <acronym>DDD</acronym> distribution
806
816
approximates a blow-by-blow account.
807
817
808
818
<div class="node">
809
819
<p><hr>
810
<small class=header>
811
Node:<a name="History">History</a>,
812
Previous:<a rel="previous" accesskey="p" href="#Contributors">Contributors</a>,
813
Up:<a rel="up" accesskey="u" href="#Summary">Summary</a>
820
<a name="History"></a>
821
Previous: <a rel="previous" accesskey="p" href="#Contributors">Contributors</a>,
822
Up: <a rel="up" accesskey="u" href="#Summary">Summary</a>
814
823
</small>
815
824
816
<br>
825
817
826
</div>
818
827
819
828
<h3 class="unnumberedsec">History of DDD</h3>
820
829
821
<p>The history of <small>DDD</small> is a story of code recycling. The oldest parts of
822
<small>DDD</small> were written in 1990, when <em>Andreas Zeller</em> designed <small>VSL</small>,
830
<p><a name="index-History-40"></a>
831
<a name="index-Zeller_002c-Andreas-41"></a><a name="index-PSG-42"></a>The history of <acronym>DDD</acronym> is a story of code recycling. The oldest parts of
832
<acronym>DDD</acronym> were written in 1990, when <em>Andreas Zeller</em> designed <acronym>VSL</acronym>,
823
833
a box-based visual structure language for visualizing data and program
824
structures. The <small>VSL</small> interpreter and the Box library became part of
834
structures. The <acronym>VSL</acronym> interpreter and the Box library became part of
825
835
Andreas' Diploma Thesis, a graphical syntax editor based on the
826
Programming System Generator <small>PSG</small>.
836
Programming System Generator <acronym>PSG</acronym>.
827
837
828
<p>In 1992, the <small>VSL</small> and Box libraries were recycled for the
829
<small>NORA</small> project. For <small>NORA</small>, an experimental
838
<p><a name="index-L_00fctkehaus_002c-Dorothea-43"></a><a name="index-NORA-44"></a><a name="index-Box-library-45"></a><a name="index-VSL-46"></a>In 1992, the <acronym>VSL</acronym> and Box libraries were recycled for the
839
<acronym>NORA</acronym> project. For <acronym>NORA</acronym>, an experimental
830
840
inference-based software development tool set, Andreas wrote a graph
831
editor (based on <small>VSL</small> and the Box libraries) and facilities
841
editor (based on <acronym>VSL</acronym> and the Box libraries) and facilities
832
842
for inter-process knowledge exchange. Based on these tools,
833
<em>Dorothea L�tkehaus</em> (now <em>Dorothea Krabiell</em>) realized <small>DDD</small>
843
<em>Dorothea L�tkehaus</em> (now <em>Dorothea Krabiell</em>) realized <acronym>DDD</acronym>
834
844
as her Diploma Thesis, 1994.
835
845
836
<p>The original <small>DDD</small> had no source window; this was added by
837
Dorothea during the winter of 1994-1995. In the first quarter of 1995,
838
finally, Andreas completed <small>DDD</small> by adding command and execution
839
windows, extensions for <small>DBX</small> and remote debugging as well as
846
<p>The original <acronym>DDD</acronym> had no source window; this was added by
847
Dorothea during the winter of 1994–1995. In the first quarter of 1995,
848
finally, Andreas completed <acronym>DDD</acronym> by adding command and execution
849
windows, extensions for <acronym>DBX</acronym> and remote debugging as well as
840
850
configuration support for several architectures. Since then, Andreas
841
has further maintained and extended <small>DDD</small>, based on the comments
842
and suggestions of several <small>DDD</small> users around the world. See the
843
comments in the <small>DDD</small> source for details.
851
has further maintained and extended <acronym>DDD</acronym>, based on the comments
852
and suggestions of several <acronym>DDD</acronym> users around the world. See the
853
comments in the <acronym>DDD</acronym> source for details.
844
854
845
<p>Major <small>DDD</small> events:
855
<p>Major <acronym>DDD</acronym> events:
846
856
847
857
<dl>
848
<dt>April, 1995
849
<dd><small>DDD</small> 0.9: First <small>DDD</small> beta release.
850
851
<br><dt>May, 1995
852
<dd><small>DDD</small> 1.0: First public <small>DDD</small> release.
853
854
<br><dt>December, 1995
855
<dd><small>DDD</small> 1.4: Machine-level debugging, glyphs, Emacs integration.
856
857
<br><dt>October, 1996
858
<dd><small>DDD</small> 2.0: Color displays, <small>XDB</small> support, generic <small>DBX</small> support,
858
<dt>April, 1995<dd><acronym>DDD</acronym> 0.9: First <acronym>DDD</acronym> beta release.
859
860
<br><dt>May, 1995<dd><acronym>DDD</acronym> 1.0: First public <acronym>DDD</acronym> release.
861
862
<br><dt>December, 1995<dd><acronym>DDD</acronym> 1.4: Machine-level debugging, glyphs, Emacs integration.
863
864
<br><dt>October, 1996<dd><acronym>DDD</acronym> 2.0: Color displays, <acronym>XDB</acronym> support, generic <acronym>DBX</acronym> support,
859
865
command tool.
860
866
861
<br><dt>May, 1997
862
<dd><small>DDD</small> 2.1: Alias detection, button tips, status displays.
863
864
<br><dt>November, 1997
865
<dd><small>DDD</small> 2.2: Sessions, display shortcuts.
866
867
<br><dt>June, 1998
868
<dd><small>DDD</small> 3.0: Icon tool bar, Java support, <small>JDB</small> support.
869
870
<br><dt>December, 1998
871
<dd><small>DDD</small> 3.1: Data plotting, Perl support, Python support, Undo/Redo.
872
873
<br><dt>January, 2000
874
<dd><small>DDD</small> 3.2: New manual, Readline support, Ladebug support.
875
876
<br><dt>January, 2001
877
<dd><small>DDD</small> 3.3: Data themes, JDB 1.2 support, VxWorks support.
878
879
<br><dt>November, 2002
880
<dd><small>DDD</small> 3.3.2: Bash support.
881
882
<br><dt>March, 2003
883
<dd><small>DDD</small> 3.3.3: Better Bash support. Compiles using modern tools thanks
884
to Daniel Schepler.
867
<br><dt>May, 1997<dd><acronym>DDD</acronym> 2.1: Alias detection, button tips, status displays.
868
869
<br><dt>November, 1997<dd><acronym>DDD</acronym> 2.2: Sessions, display shortcuts.
870
871
<br><dt>June, 1998<dd><acronym>DDD</acronym> 3.0: Icon tool bar, Java support, <acronym>JDB</acronym> support.
872
873
<br><dt>December, 1998<dd><acronym>DDD</acronym> 3.1: Data plotting, Perl support, Python support, Undo/Redo.
874
875
<br><dt>January, 2000<dd><acronym>DDD</acronym> 3.2: New manual, Readline support, Ladebug support.
876
877
<br><dt>January, 2001<dd><acronym>DDD</acronym> 3.3: Data themes, JDB 1.2 support, VxWorks support.
878
879
<br><dt>November, 2002<dd><acronym>DDD</acronym> 3.3.2: Bash support.
880
881
<br><dt>March, 2003<dd><acronym>DDD</acronym> 3.3.3: Better Bash support. Compiles using modern tools thanks
882
to Daniel Schepler.
883
884
<br><dt>Dec, 2005<dd><acronym>DDD</acronym> 3.3.12-test: GNU Make support added.
885
886
<br><dt>Feb, 2006<dd><acronym>DDD</acronym> 3.3.12-test3: Modernize Python debugging
887
888
<br><dt>Feb, 2009<dd><acronym>DDD</acronym> 3.3.12: First mainstream release to include improved support
889
for Python, Bash and Make.
885
890
</dl>
886
891
887
892
<div class="node">
888
893
<p><hr>
889
<small class=header>
890
Node:<a name="Sample%20Session">Sample Session</a>,
891
Next:<a rel="next" accesskey="n" href="#Invocation">Invocation</a>,
892
Previous:<a rel="previous" accesskey="p" href="#Summary">Summary</a>,
893
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
894
<a name="Sample-Session"></a>
895
Next: <a rel="next" accesskey="n" href="#Invocation">Invocation</a>,
896
Previous: <a rel="previous" accesskey="p" href="#Summary">Summary</a>,
897
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
894
898
</small>
895
899
896
<br>
900
897
901
</div>
898
902
899
<h2 class="chapter">A Sample DDD Session</h2>
903
<h2 class="chapter">1 A Sample DDD Session</h2>
900
904
901
<p>You can use this manual at your leisure to read all about <small>DDD</small>.
905
<p>You can use this manual at your leisure to read all about <acronym>DDD</acronym>.
902
906
However, a handful of features are enough to get started using the
903
907
debugger. This chapter illustrates those features.
904
908
905
<p>The sample program <code>sample.c</code> (see <a href="#Sample%20Program">Sample Program</a>) exhibits the
906
following bug. Normally, <code>sample</code> should sort and print its
909
<p><a name="index-sample-47"></a><a name="index-sample_002ec-48"></a>The sample program <samp><span class="file">sample.c</span></samp> (see <a href="#Sample-Program">Sample Program</a>) exhibits the
910
following bug. Normally, <samp><span class="command">sample</span></samp> should sort and print its
907
911
arguments numerically, as in the following example:
908
912
909
913
<pre class="example"> $ <kbd>./sample 8 7 5 4 1 3</kbd>
910
914
1 3 4 5 7 8
911
915
$ _
912
</pre>
913
916
</pre>
914
917
<p>However, with certain arguments, this goes wrong:
915
918
916
919
<pre class="example"> $ <kbd>./sample 8000 7000 5000 1000 4000</kbd>
917
920
1000 1913 4000 5000 7000
918
921
$ _
919
</pre>
920
922
</pre>
921
923
<p>Although the output is sorted and contains the right number of
922
924
arguments, some arguments are missing and replaced by bogus numbers;
923
925
here, <code>8000</code> is missing and replaced by
924
<code>1913</code>.<a rel="footnote" href="#fn-3"><sup>3</sup></a>
926
<code>1913</code>.<a rel="footnote" href="#fn-3" name="fnd-3"><sup>3</sup></a>
925
927
926
<p>Let us use <small>DDD</small> to see what is going on. First, you must compile
927
<code>sample.c</code> for debugging (see <a href="#Compiling%20for%20Debugging">Compiling for Debugging</a>), giving
928
the <code>-g</code> flag while compiling:
928
<p>Let us use <acronym>DDD</acronym> to see what is going on. First, you must compile
929
<samp><span class="file">sample.c</span></samp> for debugging (see <a href="#Compiling-for-Debugging">Compiling for Debugging</a>), giving
930
the <samp><span class="option">-g</span></samp> flag while compiling:
929
931
930
932
<pre class="example"> $ <kbd>gcc -g -o sample sample.c</kbd>
931
933
$ _
932
</pre>
933
934
<ul class="menu">
935
<li><a accesskey="1" href="#Sample%20Program">Sample Program</a>: Source <code>sample.c</code>
934
</pre>
935
<ul class="menu">
936
<li><a accesskey="1" href="#Sample-Program">Sample Program</a>: Source <samp><span class="file">sample.c</span></samp>
936
937
</ul>
937
938
938
<p>Now, you can invoke <small>DDD</small> (see <a href="#Invocation">Invocation</a>) on the
939
<code>sample</code> executable:
939
<p>Now, you can invoke <acronym>DDD</acronym> (see <a href="#Invocation">Invocation</a>) on the
940
<samp><span class="command">sample</span></samp> executable:
940
941
941
942
<pre class="example"> $ <kbd>ddd sample</kbd>
942
</pre>
943
944
<p>After a few seconds, <small>DDD</small> comes up. The <dfn>Source Window</dfn>
943
</pre>
944
<p>After a few seconds, <acronym>DDD</acronym> comes up. The <dfn>Source Window</dfn>
945
945
contains the source of your debugged program; use the <dfn>Scroll Bar</dfn>
946
946
to scroll through the file.
947
947
948
<br><p>
948
<pre class="sp">
949
950
</pre>
949
951
<div align="center"><img src="PICS/tut-invoke.jpg" alt="PICS/tut-invoke.jpg"></div>
950
<br><p>
951
<p>The <dfn>Debugger Console</dfn> (at the bottom) contains <small>DDD</small> version
952
information as well as a <small>GDB</small> prompt.<a rel="footnote" href="#fn-4"><sup>4</sup></a>
953
954
<pre class="example"> GNU DDD Version 3.3.11, by Dorothea L�tkehaus and Andreas Zeller.
952
<pre class="sp">
953
954
</pre>
955
956
The <dfn>Debugger Console</dfn> (at the bottom) contains <acronym>DDD</acronym> version
957
information as well as a <acronym>GDB</acronym> prompt.<a rel="footnote" href="#fn-4" name="fnd-4"><sup>4</sup></a>
958
959
<pre class="example"> GNU DDD Version 3.3.12, by Dorothea L�tkehaus and Andreas Zeller.
955
960
Copyright © 1995-1999 Technische Universit�t Braunschweig, Germany.
956
961
Copyright © 1999-2001 Universit�t Passau, Germany.
957
962
Copyright © 2001-2004 Universit�t des Saarlandes, Germany.
958
963
Reading symbols from sample...done.
959
964
(gdb) _
960
</pre>
961
965
</pre>
962
966
<p>The first thing to do now is to place a <dfn>Breakpoint</dfn>
963
(see <a href="#Breakpoints">Breakpoints</a>), making <code>sample</code> stop at a location you are
967
(see <a href="#Breakpoints">Breakpoints</a>), making <samp><span class="command">sample</span></samp> stop at a location you are
964
968
interested in. Click on the blank space left to the initialization of
965
<code>a</code>. The <dfn>Argument field</dfn> <code>():</code> now contains the location
966
(<code>sample.c:31</code>). Now, click on <code>Break</code> to create a breakpoint
967
at the location in <code>()</code>. You see a little red stop sign appear in
969
<code>a</code>. The <dfn>Argument field</dfn> ‘<samp><span class="samp">():</span></samp>’ now contains the location
970
(‘<samp><span class="samp">sample.c:31</span></samp>’). Now, click on ‘<samp><span class="samp">Break</span></samp>’ to create a breakpoint
971
at the location in ‘<samp><span class="samp">()</span></samp>’. You see a little red stop sign appear in
968
972
line 31.
969
973
970
974
<p>The next thing to do is to actually <dfn>execute</dfn> the program, such that
971
you can examine its behavior (see <a href="#Running">Running</a>). Select <code>Program
972
=> Run</code> to execute the program; the <code>Run Program</code> dialog
975
you can examine its behavior (see <a href="#Running">Running</a>). Select ‘<samp><span class="samp">Program
976
Run</span></samp>’ to execute the program; the ‘<samp><span class="samp">Run Program</span></samp>’ dialog
973
977
appears.
974
978
975
<br><p>
979
<pre class="sp">
980
981
</pre>
976
982
<div align="center"><img src="PICS/tut-run.jpg" alt="PICS/tut-run.jpg"></div>
977
<br><p>
978
<p>In <code>Run with Arguments</code>, you can now enter arguments for the
979
<code>sample</code> program. Enter the arguments resulting in erroneous
980
behavior here--that is, <code>8000 7000 5000 1000 4000</code>. Click on
981
<code>Run</code> to start execution with the arguments you just entered.
982
983
<p><small>GDB</small> now starts <code>sample</code>. Execution stops after a few moments as
983
<pre class="sp">
984
985
</pre>
986
987
In ‘<samp><span class="samp">Run with Arguments</span></samp>’, you can now enter arguments for the
988
<samp><span class="command">sample</span></samp> program. Enter the arguments resulting in erroneous
989
behavior here—that is, ‘<samp><span class="samp">8000 7000 5000 1000 4000</span></samp>’. Click on
990
‘<samp><span class="samp">Run</span></samp>’ to start execution with the arguments you just entered.
991
992
<p><acronym>GDB</acronym> now starts <samp><span class="command">sample</span></samp>. Execution stops after a few moments as
984
993
the breakpoint is reached. This is reported in the debugger console.
985
994
986
995
<pre class="example"> (gdb) break sample.c:31
990
999
991
1000
Breakpoint 1, main (argc=6, argv=0xbffff918) at sample.c:31
992
1001
(gdb) _
993
</pre>
994
1002
</pre>
995
1003
<p>The current execution line is indicated by a green arrow.
996
1004
997
<pre class="example"> => a = (int *)malloc((argc - 1) * sizeof(int));
998
</pre>
999
1005
<pre class="example"> a = (int *)malloc((argc - 1) * sizeof(int));
1006
</pre>
1000
1007
<p>You can now examine the variable values. To examine a simple variable,
1001
1008
you can simply move the mouse pointer on its name and leave it there.
1002
1009
After a second, a small window with the variable value pops up
1003
(see <a href="#Value%20Tips">Value Tips</a>). Try this with <code>argc</code> to see its value
1004
(<code>6</code>). The local variable <code>a</code> is not yet initialized; you'll
1010
(see <a href="#Value-Tips">Value Tips</a>). Try this with ‘<samp><span class="samp">argc</span></samp>’ to see its value
1011
(<code>6</code>). The local variable ‘<samp><span class="samp">a</span></samp>’ is not yet initialized; you'll
1005
1012
probably see <code>0x0</code> or some other invalid pointer value.
1006
1013
1007
<p>To execute the current line, click on the <code>Next</code> button on the
1014
<p>To execute the current line, click on the ‘<samp><span class="samp">Next</span></samp>’ button on the
1008
1015
command tool. The arrow advances to the following line. Now, point
1009
again on <code>a</code> to see that the value has changed and that <code>a</code>
1016
again on ‘<samp><span class="samp">a</span></samp>’ to see that the value has changed and that ‘<samp><span class="samp">a</span></samp>’
1010
1017
has actually been initialized.
1011
1018
1012
<br><p>
1019
<pre class="sp">
1020
1021
</pre>
1013
1022
<div align="center"><img src="PICS/tut-value.jpg" alt="PICS/tut-value.jpg"></div>
1014
<br><p>
1015
<p>To examine the individual values of the <code>a</code> array, enter
1016
<code>a[0]</code> in the argument field (you can clear it beforehand by
1017
clicking on <code>():</code>) and then click on the <code>Print</code> button. This
1018
prints the current value of <code>()</code> in the debugger console
1019
(see <a href="#Printing%20Values">Printing Values</a>). In our case, you'll get
1023
<pre class="sp">
1024
1025
</pre>
1026
1027
To examine the individual values of the ‘<samp><span class="samp">a</span></samp>’ array, enter
1028
‘<samp><span class="samp">a[0]</span></samp>’ in the argument field (you can clear it beforehand by
1029
clicking on ‘<samp><span class="samp">():</span></samp>’) and then click on the ‘<samp><span class="samp">Print</span></samp>’ button. This
1030
prints the current value of ‘<samp><span class="samp">()</span></samp>’ in the debugger console
1031
(see <a href="#Printing-Values">Printing Values</a>). In our case, you'll get
1020
1032
1021
1033
<pre class="example"> (gdb) print a[0]
1022
1034
$1 = 0
1023
1035
(gdb) _
1024
</pre>
1025
1026
<p>or some other value (note that <code>a</code> has only been allocated, but the
1036
</pre>
1037
<p class="noindent">or some other value (note that ‘<samp><span class="samp">a</span></samp>’ has only been allocated, but the
1027
1038
contents have not yet been initialized).
1028
1039
1029
<p>To see all members of <code>a</code> at once, you must use a special <small>GDB</small>
1030
operator. Since <code>a</code> has been allocated dynamically, <small>GDB</small> does not
1031
know its size; you must specify it explicitly using the <code>@</code>
1032
operator (see <a href="#Array%20Slices">Array Slices</a>). Enter <code>a[0]@(argc - 1)</code> in the
1033
argument field and click on the <code>Print</code> button. You get the first
1034
<code>argc - 1</code> elements of <code>a</code>, or
1040
<p>To see all members of ‘<samp><span class="samp">a</span></samp>’ at once, you must use a special <acronym>GDB</acronym>
1041
operator. Since ‘<samp><span class="samp">a</span></samp>’ has been allocated dynamically, <acronym>GDB</acronym> does not
1042
know its size; you must specify it explicitly using the ‘<samp><span class="samp">@</span></samp>’
1043
operator (see <a href="#Array-Slices">Array Slices</a>). Enter ‘<samp><span class="samp">a[0]@(argc - 1)</span></samp>’ in the
1044
argument field and click on the ‘<samp><span class="samp">Print</span></samp>’ button. You get the first
1045
<code>argc - 1</code> elements of ‘<samp><span class="samp">a</span></samp>’, or
1035
1046
1036
1047
<pre class="example"> (gdb) print a[0]@(argc - 1)
1037
1048
$2 = {0, 0, 0, 0, 0}
1038
1049
(gdb) _
1039
</pre>
1040
1041
<p>Rather than using <code>Print</code> at each stop to see the current value of
1042
<code>a</code>, you can also <dfn>display</dfn> <code>a</code>, such that its is
1043
automatically displayed. With <code>a[0]@(argc - 1)</code> still being shown
1044
in the argument field, click on <code>Display</code>. The contents of
1045
<code>a</code> are now shown in a new window, the <dfn>Data Window</dfn>. Click on
1046
<code>Rotate</code> to rotate the array horizontally.
1047
1048
<br><p>
1050
</pre>
1051
<p>Rather than using ‘<samp><span class="samp">Print</span></samp>’ at each stop to see the current value of
1052
‘<samp><span class="samp">a</span></samp>’, you can also <dfn>display</dfn> ‘<samp><span class="samp">a</span></samp>’, such that its is
1053
automatically displayed. With ‘<samp><span class="samp">a[0]@(argc - 1)</span></samp>’ still being shown
1054
in the argument field, click on ‘<samp><span class="samp">Display</span></samp>’. The contents of
1055
‘<samp><span class="samp">a</span></samp>’ are now shown in a new window, the <dfn>Data Window</dfn>. Click on
1056
‘<samp><span class="samp">Rotate</span></samp>’ to rotate the array horizontally.
1057
1058
<pre class="sp">
1059
1060
</pre>
1049
1061
<div align="center"><img src="PICS/tut-display.jpg" alt="PICS/tut-display.jpg"></div>
1050
<br><p>
1051
<p>Now comes the assignment of <code>a</code>'s members:
1052
1053
<pre class="example"> => for (i = 0; i < argc - 1; i++)
1062
<pre class="sp">
1063
1064
</pre>
1065
1066
Now comes the assignment of ‘<samp><span class="samp">a</span></samp>’'s members:
1067
1068
<pre class="example"> for (i = 0; i < argc - 1; i++)
1054
1069
a[i] = atoi(argv[i + 1]);
1055
</pre>
1056
1057
<p>You can now click on <code>Next</code> and <code>Next</code> again to see how the
1058
individual members of <code>a</code> are being assigned. Changed members are
1070
</pre>
1071
<p>You can now click on ‘<samp><span class="samp">Next</span></samp>’ and ‘<samp><span class="samp">Next</span></samp>’ again to see how the
1072
individual members of ‘<samp><span class="samp">a</span></samp>’ are being assigned. Changed members are
1059
1073
highlighted.
1060
1074
1061
<p>To resume execution of the loop, use the <code>Until</code> button. This
1062
makes <small>GDB</small> execute the program until a line greater than the current is
1063
reached. Click on <code>Until</code> until you end at the call of
1064
<code>shell_sort</code> in
1065
1066
<pre class="example"> => shell_sort(a, argc);
1067
</pre>
1068
1069
<p>At this point, <code>a</code>'s contents should be <code>8000 7000 5000 1000
1070
4000</code>. Click again on <code>Next</code> to step over the call to
1071
<code>shell_sort</code>. <small>DDD</small> ends in
1072
1073
<pre class="example"> => for (i = 0; i < argc - 1; i++)
1075
<p>To resume execution of the loop, use the ‘<samp><span class="samp">Until</span></samp>’ button. This
1076
makes <acronym>GDB</acronym> execute the program until a line greater than the current is
1077
reached. Click on ‘<samp><span class="samp">Until</span></samp>’ until you end at the call of
1078
‘<samp><span class="samp">shell_sort</span></samp>’ in
1079
1080
<pre class="example"> shell_sort(a, argc);
1081
</pre>
1082
<p>At this point, ‘<samp><span class="samp">a</span></samp>’'s contents should be ‘<samp><span class="samp">8000 7000 5000 1000
1083
4000</span></samp>’. Click again on ‘<samp><span class="samp">Next</span></samp>’ to step over the call to
1084
‘<samp><span class="samp">shell_sort</span></samp>’. <acronym>DDD</acronym> ends in
1085
1086
<pre class="example"> for (i = 0; i < argc - 1; i++)
1074
1087
printf("%d ", a[i]);
1075
</pre>
1076
1077
<p>and you see that after <code>shell_sort</code> has finished, the contents of
1078
<code>a</code> are <code>1000, 1913, 4000, 5000, 7000</code>--that is,
1079
<code>shell_sort</code> has somehow garbled the contents of <code>a</code>.
1088
</pre>
1089
<p class="noindent">and you see that after ‘<samp><span class="samp">shell_sort</span></samp>’ has finished, the contents of
1090
‘<samp><span class="samp">a</span></samp>’ are ‘<samp><span class="samp">1000, 1913, 4000, 5000, 7000</span></samp>’—that is,
1091
‘<samp><span class="samp">shell_sort</span></samp>’ has somehow garbled the contents of ‘<samp><span class="samp">a</span></samp>’.
1080
1092
1081
1093
<p>To find out what has happened, execute the program once again. This
1082
1094
time, you do not skip through the initialization, but jump directly into
1083
the <code>shell_sort</code> call. Delete the old breakpoint by selecting it
1084
and clicking on <code>Clear</code>. Then, create a new breakpoint in line 35
1085
before the call to <code>shell_sort</code>. To execute the program once
1086
again, select <code>Program => Run Again</code>.
1087
1088
<p>Once more, <small>DDD</small> ends up before the call to <code>shell_sort</code>:
1089
<pre class="example"> => shell_sort(a, argc);
1090
</pre>
1091
1092
<p>This time, you want to examine closer what <code>shell_sort</code> is doing.
1093
Click on <code>Step</code> to step into the call to <code>shell_sort</code>. This
1095
the ‘<samp><span class="samp">shell_sort</span></samp>’ call. Delete the old breakpoint by selecting it
1096
and clicking on ‘<samp><span class="samp">Clear</span></samp>’. Then, create a new breakpoint in line 35
1097
before the call to ‘<samp><span class="samp">shell_sort</span></samp>’. To execute the program once
1098
again, select ‘<samp><span class="samp">Program Run Again</span></samp>’.
1099
1100
<p>Once more, <acronym>DDD</acronym> ends up before the call to ‘<samp><span class="samp">shell_sort</span></samp>’:
1101
<pre class="example"> shell_sort(a, argc);
1102
</pre>
1103
<p>This time, you want to examine closer what ‘<samp><span class="samp">shell_sort</span></samp>’ is doing.
1104
Click on ‘<samp><span class="samp">Step</span></samp>’ to step into the call to ‘<samp><span class="samp">shell_sort</span></samp>’. This
1094
1105
leaves your program in the first executable line, or
1095
1106
1096
<pre class="example"> => int h = 1;
1097
</pre>
1098
1107
<pre class="example"> int h = 1;
1108
</pre>
1099
1109
<p>while the debugger console tells us the function just entered:
1100
1110
1101
1111
<pre class="example"> (gdb) step
1102
1112
shell_sort (a=0x8049878, size=6) at sample.c:9
1103
1113
(gdb) _
1104
</pre>
1105
1106
<p>This output that shows the function where <code>sample</code> is now suspended
1114
</pre>
1115
<p>This output that shows the function where ‘<samp><span class="samp">sample</span></samp>’ is now suspended
1107
1116
(and its arguments) is called a <dfn>stack frame display</dfn>. It shows a
1108
summary of the stack. You can use <code>Status => Backtrace</code> to
1117
summary of the stack. You can use ‘<samp><span class="samp">Status Backtrace</span></samp>’ to
1109
1118
see where you are in the stack as a whole; selecting a line (or clicking
1110
on <code>Up</code> and <code>Down</code>) will let you move through the stack. Note
1111
how the <code>a</code> display disappears when its frame is left.
1112
1113
<br><p>
1119
on ‘<samp><span class="samp">Up</span></samp>’ and ‘<samp><span class="samp">Down</span></samp>’) will let you move through the stack. Note
1120
how the ‘<samp><span class="samp">a</span></samp>’ display disappears when its frame is left.
1121
1122
<pre class="sp">
1123
1124
</pre>
1114
1125
<div align="center"><img src="PICS/tut-backtrace.jpg" alt="PICS/tut-backtrace.jpg"></div>
1115
<br><p>
1116
<p>Let us now check whether <code>shell_sort</code>'s arguments are correct.
1117
After returning to the lowest frame, enter <code>a[0]@size</code> in the
1118
argument field and click on <code>Print</code>:
1126
<pre class="sp">
1127
1128
</pre>
1129
1130
Let us now check whether ‘<samp><span class="samp">shell_sort</span></samp>’'s arguments are correct.
1131
After returning to the lowest frame, enter ‘<samp><span class="samp">a[0]@size</span></samp>’ in the
1132
argument field and click on ‘<samp><span class="samp">Print</span></samp>’:
1119
1133
1120
1134
<pre class="example"> (gdb) print a[0] @ size
1121
1135
$4 = {8000, 7000, 5000, 1000, 4000, 1913}
1122
1136
(gdb) _
1123
</pre>
1124
1137
</pre>
1125
1138
<p>Surprise! Where does this additional value <code>1913</code> come from? The
1126
answer is simple: The array size as passed in <code>size</code> to
1127
<code>shell_sort</code> is <em>too large by one</em>--<code>1913</code> is a bogus
1128
value which happens to reside in memory after <code>a</code>. And this last
1139
answer is simple: The array size as passed in ‘<samp><span class="samp">size</span></samp>’ to
1140
‘<samp><span class="samp">shell_sort</span></samp>’ is <em>too large by one</em>—<code>1913</code> is a bogus
1141
value which happens to reside in memory after ‘<samp><span class="samp">a</span></samp>’. And this last
1129
1142
value is being sorted in as well.
1130
1143
1131
1144
<p>To see whether this is actually the problem cause, you can now assign
1132
the correct value to <code>size</code> (see <a href="#Assignment">Assignment</a>). Select
1133
<code>size</code> in the source code and click on <code>Set</code>. A dialog pops
1145
the correct value to ‘<samp><span class="samp">size</span></samp>’ (see <a href="#Assignment">Assignment</a>). Select
1146
‘<samp><span class="samp">size</span></samp>’ in the source code and click on ‘<samp><span class="samp">Set</span></samp>’. A dialog pops
1134
1147
up where you can edit the variable value.
1135
1148
1136
<br><p>
1149
<pre class="sp">
1150
1151
</pre>
1137
1152
<div align="center"><img src="PICS/tut-set.jpg" alt="PICS/tut-set.jpg"></div>
1138
<br><p>
1139
<p>Change the value of <code>size</code> to <code>5</code> and click on <code>OK</code>.
1140
Then, click on <code>Finish</code> to resume execution of the
1141
<code>shell_sort</code> function:
1153
<pre class="sp">
1154
1155
</pre>
1156
1157
Change the value of ‘<samp><span class="samp">size</span></samp>’ to <code>5</code> and click on ‘<samp><span class="samp">OK</span></samp>’.
1158
Then, click on ‘<samp><span class="samp">Finish</span></samp>’ to resume execution of the
1159
‘<samp><span class="samp">shell_sort</span></samp>’ function:
1142
1160
1143
1161
<pre class="example"> (gdb) set variable size = 5
1144
1162
(gdb) finish
1145
1163
Run till exit from #0 shell_sort (a=0x8049878, size=5) at sample.c:9
1146
1164
0x80486ed in main (argc=6, argv=0xbffff918) at sample.c:35
1147
1165
(gdb) _
1148
</pre>
1149
1150
<p>Success! The <code>a</code> display now contains the correct values
1151
<code>1000, 4000, 5000, 7000, 8000</code>.
1152
1153
<br><p>
1166
</pre>
1167
<p>Success! The ‘<samp><span class="samp">a</span></samp>’ display now contains the correct values
1168
‘<samp><span class="samp">1000, 4000, 5000, 7000, 8000</span></samp>’.
1169
1170
<pre class="sp">
1171
1172
</pre>
1154
1173
<div align="center"><img src="PICS/tut-finish.jpg" alt="PICS/tut-finish.jpg"></div>
1155
<br><p>
1156
<p>You can verify that these values are actually printed to standard output
1157
by further executing the program. Click on <code>Cont</code> to continue
1174
<pre class="sp">
1175
1176
</pre>
1177
1178
You can verify that these values are actually printed to standard output
1179
by further executing the program. Click on ‘<samp><span class="samp">Cont</span></samp>’ to continue
1158
1180
execution.
1159
1181
1160
1182
<pre class="example"> (gdb) cont
1162
1184
1163
1185
Program exited normally.
1164
1186
(gdb) _
1165
</pre>
1166
1167
<p>The message <code>Program exited normally.</code> is from <small>GDB</small>; it indicates
1168
that the <code>sample</code> program has finished executing.
1187
</pre>
1188
<p>The message ‘<samp><span class="samp">Program exited normally.</span></samp>’ is from <acronym>GDB</acronym>; it indicates
1189
that the <samp><span class="command">sample</span></samp> program has finished executing.
1169
1190
1170
1191
<p>Having found the problem cause, you can now fix the source code. Click
1171
on <code>Edit</code> to edit <code>sample.c</code>, and change the line
1192
on ‘<samp><span class="samp">Edit</span></samp>’ to edit <samp><span class="file">sample.c</span></samp>, and change the line
1172
1193
1173
1194
<pre class="example"> shell_sort(a, argc);
1174
</pre>
1175
1176
<p>to the correct invocation
1195
</pre>
1196
<p class="noindent">to the correct invocation
1177
1197
1178
1198
<pre class="example"> shell_sort(a, argc - 1);
1179
</pre>
1180
1181
<p>You can now recompile <code>sample</code>
1199
</pre>
1200
<p>You can now recompile <samp><span class="command">sample</span></samp>
1182
1201
1183
1202
<pre class="example"> $ <kbd>gcc -g -o sample sample.c</kbd>
1184
1203
$ _
1185
</pre>
1186
1187
<p>and verify (via <code>Program => Run Again</code>) that <code>sample</code>
1204
</pre>
1205
<p class="noindent">and verify (via ‘<samp><span class="samp">Program Run Again</span></samp>’) that <samp><span class="command">sample</span></samp>
1188
1206
works fine now.
1189
1207
1190
1208
<pre class="example"> (gdb) run
1195
1213
1196
1214
Program exited normally.
1197
1215
(gdb) _
1198
</pre>
1199
1200
<p>All is done; the program works fine now. You can end this <small>DDD</small>
1201
session with <code>Program => Exit</code> or <kbd>Ctrl+Q</kbd>.
1216
</pre>
1217
<p>All is done; the program works fine now. You can end this <acronym>DDD</acronym>
1218
session with ‘<samp><span class="samp">Program Exit</span></samp>’ or <kbd>Ctrl+Q</kbd>.
1202
1219
1203
1220
<div class="node">
1204
1221
<p><hr>
1205
<small class=header>
1206
Node:<a name="Sample%20Program">Sample Program</a>,
1207
Up:<a rel="up" accesskey="u" href="#Sample%20Session">Sample Session</a>
1222
<a name="Sample-Program"></a>
1223
Up: <a rel="up" accesskey="u" href="#Sample-Session">Sample Session</a>
1208
1224
</small>
1209
1225
1210
<br>
1226
1211
1227
</div>
1212
1228
1213
<h3 class="section">Sample Program</h3>
1214
1215
<p>Here's the source <code>sample.c</code> of the sample program.
1216
1217
<pre class="smallexample"> /* sample.c -- Sample C program to be debugged with <small>DDD</small> */
1229
<h3 class="section">1.1 Sample Program</h3>
1230
1231
<p><a name="index-sample_002ec-49"></a>Here's the source <samp><span class="file">sample.c</span></samp> of the sample program.
1232
1233
<p class="noindent">
1234
<pre class="smallexample"> <p><table class="cartouche" summary="cartouche" border="1"><tr><td>
1235
/* sample.c -- Sample C program to be debugged with <acronym>DDD</acronym> */
1218
1236
1219
1237
#include <stdio.h>
1220
1238
#include <stdlib.h>
1257
1275
free(a);
1258
1276
return 0;
1259
1277
}
1260
</pre>
1261
1262
<div class="node">
1278
</td></tr></table>
1279
</pre>
1280
<div class="node">
1263
1281
<p><hr>
1264
<small class=header>
1265
Node:<a name="Invocation">Invocation</a>,
1266
Next:<a rel="next" accesskey="n" href="#Windows">Windows</a>,
1267
Previous:<a rel="previous" accesskey="p" href="#Sample%20Session">Sample Session</a>,
1268
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
1282
<a name="Invocation"></a>
1283
Next: <a rel="next" accesskey="n" href="#Windows">Windows</a>,
1284
Previous: <a rel="previous" accesskey="p" href="#Sample-Session">Sample Session</a>,
1285
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
1269
1286
</small>
1270
1287
1271
<br>
1288
1272
1289
</div>
1273
1290
1274
<h2 class="chapter">Getting In and Out of DDD</h2>
1291
<h2 class="chapter">2 Getting In and Out of DDD</h2>
1275
1292
1276
<p>This chapter discusses how to start <small>DDD</small>, and how to get out of it.
1293
<p>This chapter discusses how to start <acronym>DDD</acronym>, and how to get out of it.
1277
1294
The essentials are:
1278
1295
1279
1296
<ul>
1280
<li>Type <code>ddd</code> to start <small>DDD</small> (see <a href="#Invoking">Invoking</a>).
1281
<li>Use <code>File => Exit</code> or <kbd>Ctrl+Q</kbd> to exit (see <a href="#Quitting">Quitting</a>).
1297
<li>Type ‘<samp><span class="samp">ddd</span></samp>’ to start <acronym>DDD</acronym> (see <a href="#Invoking">Invoking</a>).
1298
<li><a name="index-Ctrl_002bQ-50"></a>Use ‘<samp><span class="samp">File Exit</span></samp>’ or <kbd>Ctrl+Q</kbd> to exit (see <a href="#Quitting">Quitting</a>).
1282
1299
</ul>
1283
1300
1284
1301
<ul class="menu">
1285
<li><a accesskey="1" href="#Invoking">Invoking</a>: How to invoke <small>DDD</small>.
1286
<li><a accesskey="2" href="#Quitting">Quitting</a>: How to quit <small>DDD</small>.
1302
<li><a accesskey="1" href="#Invoking">Invoking</a>: How to invoke <acronym>DDD</acronym>.
1303
<li><a accesskey="2" href="#Quitting">Quitting</a>: How to quit <acronym>DDD</acronym>.
1287
1304
<li><a accesskey="3" href="#Sessions">Sessions</a>: Saving work across invocations.
1288
<li><a accesskey="4" href="#Remote%20Debugging">Remote Debugging</a>: Running <small>DDD</small> on a different host.
1289
<li><a accesskey="5" href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>: How <small>DDD</small> and <small>GDB</small> communicate.
1305
<li><a accesskey="4" href="#Remote-Debugging">Remote Debugging</a>: Running <acronym>DDD</acronym> on a different host.
1306
<li><a accesskey="5" href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>: How <acronym>DDD</acronym> and <acronym>GDB</acronym> communicate.
1290
1307
</ul>
1291
1308
1292
1309
<div class="node">
1293
1310
<p><hr>
1294
<small class=header>
1295
Node:<a name="Invoking">Invoking</a>,
1296
Next:<a rel="next" accesskey="n" href="#Quitting">Quitting</a>,
1297
Up:<a rel="up" accesskey="u" href="#Invocation">Invocation</a>
1311
<a name="Invoking"></a>
1312
Next: <a rel="next" accesskey="n" href="#Quitting">Quitting</a>,
1313
Up: <a rel="up" accesskey="u" href="#Invocation">Invocation</a>
1298
1314
</small>
1299
1315
1300
<br>
1316
1301
1317
</div>
1302
1318
1303
<h3 class="section">Invoking DDD</h3>
1304
1305
<p>Normally, you can run <small>DDD</small> by invoking the program
1306
<code>ddd</code>.
1307
1308
<p>You can also run <small>DDD</small> with a variety of arguments and options, to
1319
<h3 class="section">2.1 Invoking DDD</h3>
1320
1321
<p><a name="index-Invoking-51"></a>
1322
Normally, you can run <acronym>DDD</acronym> by invoking the program
1323
<samp><span class="command">ddd</span></samp>.
1324
1325
<p>You can also run <acronym>DDD</acronym> with a variety of arguments and options, to
1309
1326
specify more of your debugging environment at the outset.
1310
1327
1311
<p>The most usual way to start <small>DDD</small> is with one argument, specifying
1328
<p>The most usual way to start <acronym>DDD</acronym> is with one argument, specifying
1312
1329
an executable program:
1313
1330
1314
1331
<pre class="example"> ddd <var>program</var>
1315
</pre>
1316
1317
<p>If you use <small>GDB</small>, <small>DBX</small>, Ladebug, or <small>XDB</small> as inferior debuggers, you can also
1332
</pre>
1333
<p class="noindent">If you use <acronym>GDB</acronym>, <acronym>DBX</acronym>, Ladebug, or <acronym>XDB</acronym> as inferior debuggers, you can also
1318
1334
start with both an executable program and a core file specified:
1319
1335
1320
1336
<pre class="example"> ddd <var>program</var> <var>core</var>
1321
</pre>
1322
1337
</pre>
1323
1338
<p>You can, instead, specify a process ID as a second argument, if you want
1324
1339
to debug a running process:
1325
1340
1326
1341
<pre class="example"> ddd <var>program</var> 1234
1327
</pre>
1328
1329
<p>would attach <small>DDD</small> to process <code>1234</code> (unless you also have a file
1330
named <code>1234</code>; <small>DDD</small> does check for a core file first).
1331
1332
<p>You can further control <small>DDD</small> by invoking it with specific
1333
<dfn>options</dfn>. To get a list of <small>DDD</small> options, invoke <small>DDD</small>
1342
</pre>
1343
<p class="noindent">would attach <acronym>DDD</acronym> to process <code>1234</code> (unless you also have a file
1344
named <samp><span class="file">1234</span></samp>; <acronym>DDD</acronym> does check for a core file first).
1345
1346
<p><a name="index-Option-52"></a>You can further control <acronym>DDD</acronym> by invoking it with specific
1347
<dfn>options</dfn>. To get a list of <acronym>DDD</acronym> options, invoke <acronym>DDD</acronym>
1334
1348
as
1335
1349
1336
1350
<pre class="example"> ddd --help
1337
</pre>
1338
1351
</pre>
1339
1352
<p>Most important are the options to specify the inferior debugger
1340
(see <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>), but you can also customize
1341
several aspects of <small>DDD</small> upon invocation (see <a href="#Options">Options</a>).
1342
1343
<p><small>DDD</small> also understands the usual X options such as <code>-display</code>
1344
or <code>-geometry</code>. See <a href="#X%20Options">X Options</a>, for details.
1345
1346
<p>All arguments and options that are not understood by <small>DDD</small> are
1347
passed to the inferior debugger; See <a href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>, for a
1353
(see <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a>), but you can also customize
1354
several aspects of <acronym>DDD</acronym> upon invocation (see <a href="#Options">Options</a>).
1355
1356
<p><acronym>DDD</acronym> also understands the usual X options such as <samp><span class="option">-display</span></samp>
1357
or <samp><span class="option">-geometry</span></samp>. See <a href="#X-Options">X Options</a>, for details.
1358
1359
<p>All arguments and options that are not understood by <acronym>DDD</acronym> are
1360
passed to the inferior debugger; See <a href="#Inferior-Debugger-Options">Inferior Debugger Options</a>, for a
1348
1361
survey. To pass an option to the inferior debugger that conflicts with
1349
an X option, or with a <small>DDD</small> option listed here, use the
1350
<code>--debugger</code> option (see <a href="#Options">Options</a>).
1362
an X option, or with a <acronym>DDD</acronym> option listed here, use the
1363
<samp><span class="option">--debugger</span></samp> option (see <a href="#Options">Options</a>).
1351
1364
1352
1365
<ul class="menu">
1353
<li><a accesskey="1" href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>: Which debugger to use?
1354
<li><a accesskey="2" href="#Options">Options</a>: How to invoke <small>DDD</small>
1355
<li><a accesskey="3" href="#X%20Options">X Options</a>: Setting X properties
1356
<li><a accesskey="4" href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>: Customizing <small>GDB</small>, <small>DBX</small>, and so on
1357
<li><a accesskey="5" href="#Multiple%20Instances">Multiple Instances</a>: Running multiple <small>DDD</small> instances
1358
<li><a accesskey="6" href="#X%20Warnings">X Warnings</a>: Turning off obnoxious warnings
1366
<li><a accesskey="1" href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a>: Which debugger to use?
1367
<li><a accesskey="2" href="#Options">Options</a>: How to invoke <acronym>DDD</acronym>
1368
<li><a accesskey="3" href="#X-Options">X Options</a>: Setting X properties
1369
<li><a accesskey="4" href="#Inferior-Debugger-Options">Inferior Debugger Options</a>: Customizing <acronym>GDB</acronym>, <acronym>DBX</acronym>, and so on
1370
<li><a accesskey="5" href="#Multiple-Instances">Multiple Instances</a>: Running multiple <acronym>DDD</acronym> instances
1371
<li><a accesskey="6" href="#X-Warnings">X Warnings</a>: Turning off obnoxious warnings
1359
1372
</ul>
1360
1373
1361
1374
<div class="node">
1362
1375
<p><hr>
1363
<small class=header>
1364
Node:<a name="Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>,
1365
Next:<a rel="next" accesskey="n" href="#Options">Options</a>,
1366
Up:<a rel="up" accesskey="u" href="#Invoking">Invoking</a>
1376
<a name="Choosing-an-Inferior-Debugger"></a>
1377
Next: <a rel="next" accesskey="n" href="#Options">Options</a>,
1378
Up: <a rel="up" accesskey="u" href="#Invoking">Invoking</a>
1367
1379
</small>
1368
1380
1369
<br>
1381
1370
1382
</div>
1371
1383
1372
<h4 class="subsection">Choosing an Inferior Debugger</h4>
1384
<h4 class="subsection">2.1.1 Choosing an Inferior Debugger</h4>
1373
1385
1374
<p>The most frequently required options are those to choose a specific
1386
<p>The most frequently required options are those to choose a specific
1375
1387
inferior debugger.
1376
1388
1377
1389
<p>Normally, the inferior debugger is determined by the program to analyze:
1378
1390
1379
1391
<ul>
1380
<li>If the program requires a specific interpreter, such as Java, Python,
1381
Perl or Bash, then you should use a <small>JDB</small>, <small>PYDB</small>, Perl, or Bash
1382
inferior debugger.
1392
<li>If the program requires a specific interpreter, such as Bash, Java,
1393
GNU Make, Perl, or Python, then you should use a Bash, <acronym>JDB</acronym>, GNU
1394
Make, Perl, <code>pydb</code>, Bash, or inferior debugger.
1383
1395
1384
1396
<p>Use
1385
1397
1398
<p><a name="index-Bash_002c-invoking-_0040DDD_007b_007d-with-53"></a>
1399
<pre class="example"> ddd --bash <var>program</var>
1400
ddd --interpreter='<em>path-to-debugger-bash</em> --debugger' <var>program</var>
1401
</pre>
1402
<p><a name="index-g_t_0040acronym_007bJDB_007d_002c-invoking-_0040DDD_007b_007d-with-54"></a>
1386
1403
<pre class="example"> ddd --jdb <var>program</var>
1387
</pre>
1388
1404
</pre>
1405
<p><a name="index-GNU-Make_002c-invoking-_0040DDD_007b_007d-with-55"></a>
1406
<pre class="example"> ddd --make <var>program</var>
1407
ddd --interpreter='<em>path-to-debugger-make</em> --debugger' <var>program</var>
1408
</pre>
1409
<p><a name="index-Perl_002c-invoking-_0040DDD_007b_007d-with-56"></a>
1410
<pre class="example"> ddd --perl <var>program</var>
1411
</pre>
1412
<p><a name="index-g_t_0040acronym_007bPYDB_007d_002c-invoking-_0040DDD_007b_007d-with-57"></a>
1389
1413
<pre class="example"> ddd --pydb <var>program</var>
1390
</pre>
1391
1392
<pre class="example"> ddd --perl <var>program</var>
1393
</pre>
1394
1395
<pre class="example"> ddd --bash <var>program</var>
1396
ddd --interpreter='<em>path-to-debugger-bash</em> --debugger' <var>program</var>
1397
</pre>
1398
1399
<p>to run <small>DDD</small> with <small>JDB</small>, <small>PYDB</small>, Perl, or Bash as an inferior
1414
</pre>
1415
<p class="noindent">to run <acronym>DDD</acronym> with <acronym>JDB</acronym>, <code>pydb</code>, Perl, Bash, or GNU Make as an inferior
1400
1416
debugger.
1401
1417
1402
</p><li>If the program is an executable binary, you should use <small>GDB</small>, <small>DBX</small>,
1403
Ladebug, or <small>XDB</small>. In general, <small>GDB</small> (or its HP variant, <small>WDB</small>)
1418
<li>If the program is an executable binary, you should use <acronym>DBX</acronym>, <acronym>GDB</acronym>,
1419
Ladebug, or <acronym>XDB</acronym>. In general, <acronym>GDB</acronym> (or its HP variant, <acronym>WDB</acronym>)
1404
1420
provides the most functionality of these debuggers.
1405
1421
1406
1422
<p>Use
1407
1423
1424
<p><a name="index-g_t_0040acronym_007bDBX_007d_002c-invoking-_0040DDD_007b_007d-with-58"></a>
1425
<pre class="example"> ddd --dbx <var>program</var>
1426
</pre>
1427
<p><a name="index-g_t_0040acronym_007bGDB_007d_002c-invoking-_0040DDD_007b_007d-with-59"></a>
1408
1428
<pre class="example"> ddd --gdb <var>program</var>
1409
</pre>
1410
1429
</pre>
1430
<p><a name="index-Ladebug_002c-invoking-_0040DDD_007b_007d-with-60"></a>
1431
<pre class="example"> ddd --ladebug <var>program</var>
1432
</pre>
1433
<p><a name="index-g_t_0040acronym_007bWDB_007d_002c-invoking-_0040DDD_007b_007d-with-61"></a>
1411
1434
<pre class="example"> ddd --wdb <var>program</var>
1412
</pre>
1413
1414
<pre class="example"> ddd --dbx <var>program</var>
1415
</pre>
1416
1417
<pre class="example"> ddd --ladebug <var>program</var>
1418
</pre>
1419
1435
</pre>
1436
<p><a name="index-g_t_0040acronym_007bXDB_007d_002c-invoking-_0040DDD_007b_007d-with-62"></a>
1420
1437
<pre class="example"> ddd --xdb <var>program</var>
1421
</pre>
1422
1423
<p>to run <small>DDD</small> with <small>GDB</small>, <small>WDB</small>, <small>DBX</small>, Ladebug, or <small>XDB</small> as
1438
</pre>
1439
<p class="noindent">to run <acronym>DDD</acronym> with <acronym>GDB</acronym>, <acronym>WDB</acronym>, <acronym>DBX</acronym>, Ladebug, or <acronym>XDB</acronym> as
1424
1440
inferior debugger.
1425
1441
</ul>
1426
1442
1427
<p>If you invoke <small>DDD</small> without any of these options, but give a
1428
<var>program</var> to analyze, then <small>DDD</small> will automatically determine
1443
<p>If you invoke <acronym>DDD</acronym> without any of these options, but give a
1444
<var>program</var> to analyze, then <acronym>DDD</acronym> will automatically determine
1429
1445
the inferior debugger:
1430
1446
1431
1447
<ul>
1432
1448
<li>If <var>program</var> is a Python program, a Perl script, or a Java class,
1433
<small>DDD</small> will invoke the appropriate debugger.
1449
<acronym>DDD</acronym> will invoke the appropriate debugger.
1434
1450
1435
<li>If <var>program</var> is an executable binary, <small>DDD</small> will invoke its
1436
default debugger for executables (usually <small>GDB</small>).
1451
<li>If <var>program</var> is an executable binary, <acronym>DDD</acronym> will invoke its
1452
default debugger for executables (usually <acronym>GDB</acronym>).
1437
1453
</ul>
1438
1454
1439
<p>See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>, for more details on determining
1455
<p>See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>, for more details on determining
1440
1456
the inferior debugger.
1441
1457
1442
1458
<div class="node">
1443
1459
<p><hr>
1444
<small class=header>
1445
Node:<a name="Options">Options</a>,
1446
Next:<a rel="next" accesskey="n" href="#X%20Options">X Options</a>,
1447
Previous:<a rel="previous" accesskey="p" href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>,
1448
Up:<a rel="up" accesskey="u" href="#Invoking">Invoking</a>
1460
<a name="Options"></a>
1461
Next: <a rel="next" accesskey="n" href="#X-Options">X Options</a>,
1462
Previous: <a rel="previous" accesskey="p" href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a>,
1463
Up: <a rel="up" accesskey="u" href="#Invoking">Invoking</a>
1449
1464
</small>
1450
1465
1451
<br>
1466
1452
1467
</div>
1453
1468
1454
<h4 class="subsection">DDD Options</h4>
1469
<h4 class="subsection">2.1.2 DDD Options</h4>
1455
1470
1456
<p>You can further control how <small>DDD</small> starts up using the following
1471
<p>You can further control how <acronym>DDD</acronym> starts up using the following
1457
1472
options. All options may be abbreviated, as long as they are
1458
unambiguous; single dashes <code>-</code> instead of double dashes <code>--</code>
1459
may also be used. Almost all options control a specific <small>DDD</small>
1473
unambiguous; single dashes <samp><span class="option">-</span></samp> instead of double dashes <samp><span class="option">--</span></samp>
1474
may also be used. Almost all options control a specific <acronym>DDD</acronym>
1460
1475
resource or resource class (see <a href="#Customizing">Customizing</a>).
1461
1476
1462
1477
<dl>
1463
<dt><code>--attach-windows</code>
1464
<dd>Attach the source and data windows to the debugger console, creating
1465
one single big <small>DDD</small> window. This is the default setting.
1478
<dt><samp><span class="option">--attach-windows</span></samp><dd>Attach the source and data windows to the debugger console, creating
1479
one single big <acronym>DDD</acronym> window. This is the default setting.
1466
1480
1467
<p>Giving this option is equivalent to setting the <small>DDD</small>
1468
<code>Separate</code> resource class to <code>off</code>. See <a href="#Window%20Layout">Window Layout</a>, for
1481
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1482
‘<samp><span class="samp">Separate</span></samp>’ resource class to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Window-Layout">Window Layout</a>, for
1469
1483
details.
1470
1484
1471
<br><dt><code>--attach-source-window</code>
1472
<dd>Attach only the source window to the debugger console.
1473
1474
<p>Giving this option is equivalent to setting the <small>DDD</small>
1475
<code>separateSourceWindow</code> resource to <code>off</code>.
1476
See <a href="#Window%20Layout">Window Layout</a>, for details.
1477
1478
<br><dt><code>--attach-data-window</code>
1479
<dd>Attach only the source window to the debugger console.
1480
1481
<p>Giving this option is equivalent to setting the <small>DDD</small>
1482
<code>separateDataWindow</code> resource to <code>off</code>. See <a href="#Window%20Layout">Window Layout</a>,
1485
<br><dt><samp><span class="option">--attach-source-window</span></samp><dd>Attach only the source window to the debugger console.
1486
1487
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1488
‘<samp><span class="samp">separateSourceWindow</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’.
1489
See <a href="#Window-Layout">Window Layout</a>, for details.
1490
1491
<br><dt><samp><span class="option">--attach-data-window</span></samp><dd>Attach only the source window to the debugger console.
1492
1493
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1494
‘<samp><span class="samp">separateDataWindow</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Window-Layout">Window Layout</a>,
1483
1495
for details.
1484
1496
1485
<br><dt><code>--automatic-debugger</code>
1486
<dd>Determine the inferior debugger automatically from the given arguments.
1487
1488
<p>Giving this option is equivalent to setting the <small>DDD</small>
1489
<code>autoDebugger</code> resource to <code>on</code>.
1490
See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>, for details.
1491
1492
<br><dt><code>--button-tips</code>
1493
<dd>Enable button tips.
1494
1495
<p>Giving this option is equivalent to setting the <small>DDD</small>
1496
<code>buttonTips</code> resource to <code>on</code>. See <a href="#Customizing%20Help">Customizing Help</a>, for
1497
<br><dt><samp><span class="option">--automatic-debugger</span></samp><dd>Determine the inferior debugger automatically from the given arguments.
1498
1499
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1500
‘<samp><span class="samp">autoDebugger</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’.
1501
See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>, for details.
1502
1503
<br><dt><samp><span class="option">--button-tips</span></samp><dd>Enable button tips.
1504
1505
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1506
‘<samp><span class="samp">buttonTips</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Customizing-Help">Customizing Help</a>, for
1497
1507
details.
1498
1508
1499
<br><dt><code>--configuration</code>
1500
<dd>Print the <small>DDD</small> configuration settings on standard output and
1509
<br><dt><samp><span class="option">--configuration</span></samp><dd>Print the <acronym>DDD</acronym> configuration settings on standard output and
1501
1510
exit.
1502
1511
1503
<p>Giving this option is equivalent to setting the <small>DDD</small>
1504
<code>showConfiguration</code> resource to <code>on</code>. See <a href="#Diagnostics">Diagnostics</a>, for
1512
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1513
‘<samp><span class="samp">showConfiguration</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Diagnostics">Diagnostics</a>, for
1505
1514
details.
1506
1515
1507
<br><dt><code>--check-configuration</code>
1508
<dd>Check the <small>DDD</small> environment (in particular, the X configuration),
1516
<br><dt><samp><span class="option">--check-configuration</span></samp><dd>Check the <acronym>DDD</acronym> environment (in particular, the X configuration),
1509
1517
report any possible problem causes and exit.
1510
1518
1511
<p>Giving this option is equivalent to setting the <small>DDD</small>
1512
<code>checkConfiguration</code> resource to <code>on</code>. See <a href="#Diagnostics">Diagnostics</a>,
1513
for details.
1514
1515
<br><dt><code>--data-window</code>
1516
<dd>Open the data window upon start-up.
1517
1518
<p>Giving this option is equivalent to setting the <small>DDD</small>
1519
<code>openDataWindow</code> resource to <code>on</code>. See <a href="#Toggling%20Windows">Toggling Windows</a>,
1520
for details.
1521
1522
<br><dt><code>--dbx</code>
1523
<dd>Run <small>DBX</small> as inferior debugger.
1524
1525
<p>Giving this option is equivalent to setting the <small>DDD</small>
1526
<code>debugger</code> resource to <code>dbx</code>.
1527
See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>, for details.
1528
1529
<br><dt><code>--debugger </code><var>name</var><code></code>
1530
<dd>Invoke the inferior debugger <var>name</var>. This is useful if you have
1519
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1520
‘<samp><span class="samp">checkConfiguration</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Diagnostics">Diagnostics</a>,
1521
for details.
1522
1523
<br><dt><samp><span class="option">--data-window</span></samp><dd>Open the data window upon start-up.
1524
1525
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1526
‘<samp><span class="samp">openDataWindow</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Toggling-Windows">Toggling Windows</a>,
1527
for details.
1528
1529
<br><dt><samp><span class="option">--dbx</span></samp><dd>Run <acronym>DBX</acronym> as inferior debugger.
1530
1531
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1532
‘<samp><span class="samp">debugger</span></samp>’ resource to ‘<samp><span class="samp">dbx</span></samp>’.
1533
See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>, for details.
1534
1535
<br><dt><samp><span class="option">--debugger </span><var>name</var></samp><dd><a name="index-dbx-63"></a><a name="index-gdb-64"></a><a name="index-ladebug-65"></a><a name="index-jdb-66"></a><a name="index-mdb-67"></a><a name="index-perl-68"></a><a name="index-pydb-69"></a><a name="index-wdb-70"></a><a name="index-xdb-71"></a>Invoke the inferior debugger <var>name</var>. This is useful if you have
1531
1536
several debugger versions around, or if the inferior debugger cannot be
1532
invoked under its usual name (i.e. <code>gdb</code>, <code>wdb</code>,
1533
<code>dbx</code>, <code>xdb</code>, <code>jdb</code>, <code>pydb</code>, or
1534
<code>perl</code>).
1537
invoked under its usual name (i.e. <samp><span class="command">gdb</span></samp>, <samp><span class="command">wdb</span></samp>,
1538
<samp><span class="command">dbx</span></samp>, <samp><span class="command">xdb</span></samp>, <samp><span class="command">jdb</span></samp>, <samp><span class="command">pydb</span></samp>, or
1539
<samp><span class="command">perl</span></samp>).
1535
1540
1536
1541
<p>This option can also be used to pass options to the inferior debugger
1537
that would otherwise conflict with <small>DDD</small> options. For instance,
1538
to pass the option <code>-d </code><var>directory</var><code></code> to <small>XDB</small>, use:
1542
that would otherwise conflict with <acronym>DDD</acronym> options. For instance,
1543
to pass the option <samp><span class="option">-d </span><var>directory</var></samp> to <acronym>XDB</acronym>, use:
1539
1544
1540
1545
<pre class="example"> ddd --debugger "xdb -d <var>directory</var>"
1541
</pre>
1542
1543
<p>If you use the <code>--debugger</code> option, be sure that the type of
1546
</pre>
1547
<p class="noindent">If you use the <samp><span class="option">--debugger</span></samp> option, be sure that the type of
1544
1548
inferior debugger is specified as well. That is, use one of the options
1545
<code>--gdb</code>, <code>--dbx</code>, <code>--xdb</code>, <code>--jdb</code>,
1546
<code>--pydb</code>, or <code>--perl</code> (unless the default setting works
1549
<samp><span class="option">--gdb</span></samp>, <samp><span class="option">--dbx</span></samp>, <samp><span class="option">--xdb</span></samp>, <samp><span class="option">--jdb</span></samp>,
1550
<samp><span class="option">--pydb</span></samp>, or <samp><span class="option">--perl</span></samp> (unless the default setting works
1547
1551
fine).
1548
1552
1549
<p>Giving this option is equivalent to setting the <small>DDD</small>
1550
<code>debuggerCommand</code> resource to <var>name</var>. See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>, for details.
1551
1552
<br><dt><code>--debugger-console</code>
1553
<dd>Open the debugger console upon start-up.
1554
1555
<p>Giving this option is equivalent to setting the <small>DDD</small>
1556
<code>openDebuggerConsole</code> resource to <code>on</code>. See <a href="#Toggling%20Windows">Toggling Windows</a>, for details.
1557
1558
<br><dt><code>--disassemble</code>
1559
<dd>Disassemble the source code. See also the <code>--no-disassemble</code>
1553
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1554
‘<samp><span class="samp">debuggerCommand</span></samp>’ resource to <var>name</var>. See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>, for details.
1555
1556
<br><dt><samp><span class="option">--debugger-console</span></samp><dd>Open the debugger console upon start-up.
1557
1558
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1559
‘<samp><span class="samp">openDebuggerConsole</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Toggling-Windows">Toggling Windows</a>, for details.
1560
1561
<br><dt><samp><span class="option">--disassemble</span></samp><dd>Disassemble the source code. See also the <samp><span class="option">--no-disassemble</span></samp>
1560
1562
option, below.
1561
1563
1562
<p>Giving this option is equivalent to setting the <small>DDD</small>
1563
<code>disassemble</code> resource to <code>on</code>. See <a href="#Customizing%20Source">Customizing Source</a>,
1564
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1565
‘<samp><span class="samp">disassemble</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Customizing-Source">Customizing Source</a>,
1564
1566
for details.
1565
1567
1566
<br><dt><code>--exec-window</code>
1567
<dd>Run the debugged program in a specially created execution window. This
1568
<br><dt><samp><span class="option">--exec-window</span></samp><dd>Run the debugged program in a specially created execution window. This
1568
1569
is useful for programs that have special terminal requirements not
1569
1570
provided by the debugger window, as raw keyboard processing or terminal
1570
control sequences. See <a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>, for details.
1571
1572
<p>Giving this option is equivalent to setting the <small>DDD</small>
1573
<code>separateExecWindow</code> resource to <code>on</code>. See <a href="#Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>, for details.
1574
1575
<br><dt><code>--font </code><var>fontname</var><code></code>
1576
<dd><dt><code>-fn </code><var>fontname</var><code></code>
1577
<dd>Use <var>fontname</var> as default font.
1578
1579
<p>Giving this option is equivalent to setting the <small>DDD</small>
1580
<code>defaultFont</code> resource to <code>fontname</code>. See <a href="#Customizing%20Fonts">Customizing Fonts</a>, for details.
1581
1582
<br><dt><code>--fonts</code>
1583
<dd>Show the font definitions used by <small>DDD</small> on standard output.
1584
1585
<p>Giving this option is equivalent to setting the <small>DDD</small>
1586
<code>showFonts</code> resource to <code>on</code>. See <a href="#Diagnostics">Diagnostics</a>, for
1571
control sequences. See <a href="#Using-the-Execution-Window">Using the Execution Window</a>, for details.
1572
1573
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1574
‘<samp><span class="samp">separateExecWindow</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Customizing-the-Execution-Window">Customizing the Execution Window</a>, for details.
1575
1576
<br><dt><samp><span class="option">--font </span><var>fontname</var></samp><dt><samp><span class="option">-fn </span><var>fontname</var></samp><dd>Use <var>fontname</var> as default font.
1577
1578
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1579
‘<samp><span class="samp">defaultFont</span></samp>’ resource to ‘<samp><span class="samp">fontname</span></samp>’. See <a href="#Customizing-Fonts">Customizing Fonts</a>, for details.
1580
1581
<br><dt><samp><span class="option">--fonts</span></samp><dd>Show the font definitions used by <acronym>DDD</acronym> on standard output.
1582
1583
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1584
‘<samp><span class="samp">showFonts</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Diagnostics">Diagnostics</a>, for
1587
1585
details.
1588
1586
1589
<br><dt><code>--fontsize </code><var>size</var><code></code>
1590
<dd>Set the default font size to <var>size</var> (in 1/10 points). To make
1591
<small>DDD</small> use 12-point fonts, say <code>--fontsize 120</code>.
1592
1593
<p>Giving this option is equivalent to setting the <small>DDD</small>
1594
<code>FontSize</code> resource class to <code>size</code>. See <a href="#Customizing%20Fonts">Customizing Fonts</a>, for details.
1595
1596
<br><dt><code>--fullname</code>
1597
<dd><dt><code>-f</code>
1598
<dd>Enable the <small>TTY</small> interface, taking additional debugger commands from
1587
<br><dt><samp><span class="option">--fontsize </span><var>size</var></samp><dd>Set the default font size to <var>size</var> (in 1/10 points). To make
1588
<acronym>DDD</acronym> use 12-point fonts, say <samp><span class="option">--fontsize 120</span></samp>.
1589
1590
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1591
‘<samp><span class="samp">FontSize</span></samp>’ resource class to ‘<samp><span class="samp">size</span></samp>’. See <a href="#Customizing-Fonts">Customizing Fonts</a>, for details.
1592
1593
<br><dt><samp><span class="option">--fullname</span></samp><dt><samp><span class="option">-f</span></samp><dd>Enable the <acronym>TTY</acronym> interface, taking additional debugger commands from
1599
1594
standard input and forwarding debugger output on standard output.
1600
Current positions are issued in <small>GDB</small> <code>-fullname</code> format
1595
Current positions are issued in <acronym>GDB</acronym> <samp><span class="option">-fullname</span></samp> format
1601
1596
suitable for debugger front-ends. By default, both the debugger console
1602
and source window are disabled. See <a href="#TTY%20mode">TTY mode</a>, for a discussion.
1597
and source window are disabled. See <a href="#TTY-mode">TTY mode</a>, for a discussion.
1603
1598
1604
<p>Giving this option is equivalent to setting the <small>DDD</small>
1605
<code>TTYMode</code> resource class to <code>on</code>. See <a href="#TTY%20mode">TTY mode</a>, for
1599
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1600
‘<samp><span class="samp">TTYMode</span></samp>’ resource class to ‘<samp><span class="samp">on</span></samp>’. See <a href="#TTY-mode">TTY mode</a>, for
1606
1601
details.
1607
1602
1608
<br><dt><code>--gdb</code>
1609
<dd>Run <small>GDB</small> as inferior debugger.
1610
1611
<p>Giving this option is equivalent to setting the <small>DDD</small>
1612
<code>debugger</code> resource to <code>gdb</code>. See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>,
1613
for details.
1614
1615
<br><dt><code>--glyphs</code>
1616
<dd>Display the current execution position and breakpoints as glyphs. See
1617
also the <code>--no-glyphs</code> option, below.
1618
1619
<p>Giving this option is equivalent to setting the <small>DDD</small>
1620
<code>displayGlyphs</code> resource to <code>on</code>. See <a href="#Customizing%20Source">Customizing Source</a>,
1621
for details.
1622
1623
<br><dt><code>--help</code>
1624
<dd><dt><code>-h</code>
1625
<dd><dt><code>-?</code>
1626
<dd>Give a list of frequently used options. Show options of the inferior
1603
<br><dt><samp><span class="option">--gdb</span></samp><dd>Run <acronym>GDB</acronym> as inferior debugger.
1604
1605
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1606
‘<samp><span class="samp">debugger</span></samp>’ resource to ‘<samp><span class="samp">gdb</span></samp>’. See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>,
1607
for details.
1608
1609
<br><dt><samp><span class="option">--glyphs</span></samp><dd>Display the current execution position and breakpoints as glyphs. See
1610
also the <samp><span class="option">--no-glyphs</span></samp> option, below.
1611
1612
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1613
‘<samp><span class="samp">displayGlyphs</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Customizing-Source">Customizing Source</a>,
1614
for details.
1615
1616
<br><dt><samp><span class="option">--help</span></samp><dt><samp><span class="option">-h</span></samp><dt><samp><span class="option">-?</span></samp><dd>Give a list of frequently used options. Show options of the inferior
1627
1617
debugger as well.
1628
1618
1629
<p>Giving this option is equivalent to setting the <small>DDD</small>
1630
<code>showInvocation</code> resource to <code>on</code>. See <a href="#Diagnostics">Diagnostics</a>, for
1631
details.
1632
1633
<br><dt><code>--host </code><var>hostname</var><code></code>
1634
<dd><dt><code>--host </code><var>username</var><code>@</code><var>hostname</var><code></code>
1635
<dd>Invoke the inferior debugger directly on the remote host <var>hostname</var>.
1636
If <var>username</var> is given and the <code>--login</code> option is not used,
1637
use <var>username</var> as remote user name. See <a href="#Remote%20Debugger">Remote Debugger</a>, for
1638
details.
1639
1640
<p>Giving this option is equivalent to setting the <small>DDD</small>
1641
<code>debuggerHost</code> resource to <var>hostname</var>. See <a href="#Remote%20Debugger">Remote Debugger</a>,
1642
for details.
1643
1644
<br><dt><code>--jdb</code>
1645
<dd>Run <small>JDB</small> as inferior debugger.
1646
1647
<p>Giving this option is equivalent to setting the <small>DDD</small>
1648
<code>debugger</code> resource to <code>gdb</code>. See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>,
1649
for details.
1650
1651
<br><dt><code>--ladebug</code>
1652
<dd>Run Ladebug as inferior debugger.
1653
1654
<p>Giving this option is equivalent to setting the <small>DDD</small>
1655
<code>debugger</code> resource to <code>ladebug</code>. See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>, for details.
1656
1657
<br><dt><code>--lesstif-hacks</code>
1658
<dd>Equivalent to <code>--lesstif-version 999</code>. Deprecated.
1659
1660
<p>Giving this option is equivalent to setting the <small>DDD</small>
1661
<code>lessTifVersion</code> resource to <code>999</code>. See <a href="#LessTif">LessTif</a>, for
1662
details.
1663
1664
<br><dt><code>--lesstif-version </code><var>version</var><code></code>
1665
<dd>Enable some hacks to make <small>DDD</small> run properly with LessTif.
1619
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1620
‘<samp><span class="samp">showInvocation</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Diagnostics">Diagnostics</a>, for
1621
details.
1622
1623
<br><dt><samp><span class="option">--host </span><var>hostname</var></samp><dt><samp><span class="option">--host </span><var>username</var><span class="option">@</span><var>hostname</var></samp><dd>Invoke the inferior debugger directly on the remote host <var>hostname</var>.
1624
If <var>username</var> is given and the <samp><span class="option">--login</span></samp> option is not used,
1625
use <var>username</var> as remote user name. See <a href="#Remote-Debugger">Remote Debugger</a>, for
1626
details.
1627
1628
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1629
‘<samp><span class="samp">debuggerHost</span></samp>’ resource to <var>hostname</var>. See <a href="#Remote-Debugger">Remote Debugger</a>,
1630
for details.
1631
1632
<br><dt><samp><span class="option">--jdb</span></samp><dd>Run <acronym>JDB</acronym> as inferior debugger.
1633
1634
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1635
‘<samp><span class="samp">debugger</span></samp>’ resource to ‘<samp><span class="samp">jdb</span></samp>’. See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>,
1636
for details.
1637
1638
<br><dt><samp><span class="option">--ladebug</span></samp><dd>Run Ladebug as inferior debugger.
1639
1640
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1641
‘<samp><span class="samp">debugger</span></samp>’ resource to ‘<samp><span class="samp">ladebug</span></samp>’. See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>, for details.
1642
1643
<br><dt><samp><span class="option">--lesstif-hacks</span></samp><dd>Equivalent to <samp><span class="option">--lesstif-version 999</span></samp>. Deprecated.
1644
1645
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1646
‘<samp><span class="samp">lessTifVersion</span></samp>’ resource to <code>999</code>. See <a href="#LessTif">LessTif</a>, for
1647
details.
1648
1649
<br><dt><samp><span class="option">--lesstif-version </span><var>version</var></samp><dd>Enable some hacks to make <acronym>DDD</acronym> run properly with LessTif.
1666
1650
See <a href="#LessTif">LessTif</a>, for a discussion.
1667
1651
1668
<p>Giving this option is equivalent to setting the <small>DDD</small>
1669
<code>lessTifVersion</code> resource to <var>version</var>. See <a href="#LessTif">LessTif</a>, for
1670
details.
1671
1672
<br><dt><code>--license</code>
1673
<dd>Print the <small>DDD</small> license on standard output and exit.
1674
1675
<p>Giving this option is equivalent to setting the <small>DDD</small>
1676
<code>showLicense</code> resource to <var>on</var>. See <a href="#Diagnostics">Diagnostics</a>, for
1677
details.
1678
1679
<br><dt><code>--login </code><var>username</var><code></code>
1680
<dd><dt><code>-l </code><var>username</var><code></code>
1681
<dd>Use <var>username</var> as remote user name. See <a href="#Remote%20Debugger">Remote Debugger</a>, for details.
1682
1683
<p>Giving this option is equivalent to setting the <small>DDD</small>
1684
<code>debuggerHostLogin</code> resource to <var>username</var>. See <a href="#Remote%20Debugger">Remote Debugger</a>, for details.
1685
1686
<br><dt><code>--maintenance</code>
1687
<dd>Enable the top-level <code>Maintenance</code> menu with options for debugging
1688
<small>DDD</small>. See <a href="#Maintenance%20Menu">Maintenance Menu</a>, for details.
1689
1690
<p>Giving this option is equivalent to setting the <small>DDD</small>
1691
<code>maintenance</code> resource to <var>on</var>. See <a href="#Maintenance%20Menu">Maintenance Menu</a>, for
1692
details.
1693
1694
<br><dt><code>--manual</code>
1695
<dd>Print the <small>DDD</small> manual on standard output and exit.
1696
1697
<p>Giving this option is equivalent to setting the <small>DDD</small>
1698
<code>showManual</code> resource to <var>on</var>. See <a href="#Diagnostics">Diagnostics</a>, for
1699
details.
1700
1701
<br><dt><code>--news</code>
1702
<dd>Print the <small>DDD</small> news on standard output and exit.
1703
1704
<p>Giving this option is equivalent to setting the <small>DDD</small>
1705
<code>showNews</code> resource to <var>on</var>. See <a href="#Diagnostics">Diagnostics</a>, for details.
1706
1707
<br><dt><code>--no-button-tips</code>
1708
<dd>Disable button tips.
1709
1710
<p>Giving this option is equivalent to setting the <small>DDD</small>
1711
<code>buttonTips</code> resource to <code>off</code>. See <a href="#Customizing%20Help">Customizing Help</a>, for
1712
details.
1713
1714
<br><dt><code>--no-data-window</code>
1715
<dd>Do not open the data window upon start-up.
1716
1717
<p>Giving this option is equivalent to setting the <small>DDD</small>
1718
<code>openDataWindow</code> resource to <code>off</code>. See <a href="#Toggling%20Windows">Toggling Windows</a>,
1719
for details.
1720
1721
<br><dt><code>--no-debugger-console</code>
1722
<dd>Do not open the debugger console upon start-up.
1723
1724
<p>Giving this option is equivalent to setting the <small>DDD</small>
1725
<code>openDebuggerConsole</code> resource to <code>off</code>. See <a href="#Toggling%20Windows">Toggling Windows</a>, for details.
1726
1727
<br><dt><code>--no-disassemble</code>
1728
<dd>Do not disassemble the source code.
1729
1730
<p>Giving this option is equivalent to setting the <small>DDD</small>
1731
<code>disassemble</code> resource to <code>off</code>. See <a href="#Customizing%20Source">Customizing Source</a>,
1732
for details.
1733
1734
<br><dt><code>--no-exec-window</code>
1735
<dd>Do not run the debugged program in a specially created execution window;
1652
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1653
‘<samp><span class="samp">lessTifVersion</span></samp>’ resource to <var>version</var>. See <a href="#LessTif">LessTif</a>, for
1654
details.
1655
1656
<br><dt><samp><span class="option">--license</span></samp><dd><a name="index-License_002c-showing-on-standard-output-72"></a>Print the <acronym>DDD</acronym> license on standard output and exit.
1657
1658
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1659
‘<samp><span class="samp">showLicense</span></samp>’ resource to <var>on</var>. See <a href="#Diagnostics">Diagnostics</a>, for
1660
details.
1661
1662
<br><dt><samp><span class="option">--login </span><var>username</var></samp><dt><samp><span class="option">-l </span><var>username</var></samp><dd>Use <var>username</var> as remote user name. See <a href="#Remote-Debugger">Remote Debugger</a>, for details.
1663
1664
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1665
‘<samp><span class="samp">debuggerHostLogin</span></samp>’ resource to <var>username</var>. See <a href="#Remote-Debugger">Remote Debugger</a>, for details.
1666
1667
<br><dt><samp><span class="option">--maintenance</span></samp><dd>Enable the top-level ‘<samp><span class="samp">Maintenance</span></samp>’ menu with options for debugging
1668
<acronym>DDD</acronym>. See <a href="#Maintenance-Menu">Maintenance Menu</a>, for details.
1669
1670
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1671
‘<samp><span class="samp">maintenance</span></samp>’ resource to <var>on</var>. See <a href="#Maintenance-Menu">Maintenance Menu</a>, for
1672
details.
1673
1674
<br><dt><samp><span class="option">--manual</span></samp><dd><a name="index-Manual_002c-showing-on-standard-output-73"></a>Print the <acronym>DDD</acronym> manual on standard output and exit.
1675
1676
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1677
‘<samp><span class="samp">showManual</span></samp>’ resource to <var>on</var>. See <a href="#Diagnostics">Diagnostics</a>, for
1678
details.
1679
1680
<br><dt><samp><span class="option">--news</span></samp><dd><a name="index-News_002c-showing-on-standard-output-74"></a>Print the <acronym>DDD</acronym> news on standard output and exit.
1681
1682
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1683
‘<samp><span class="samp">showNews</span></samp>’ resource to <var>on</var>. See <a href="#Diagnostics">Diagnostics</a>, for details.
1684
1685
<br><dt><samp><span class="option">--no-button-tips</span></samp><dd>Disable button tips.
1686
1687
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1688
‘<samp><span class="samp">buttonTips</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Customizing-Help">Customizing Help</a>, for
1689
details.
1690
1691
<br><dt><samp><span class="option">--no-data-window</span></samp><dd>Do not open the data window upon start-up.
1692
1693
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1694
‘<samp><span class="samp">openDataWindow</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Toggling-Windows">Toggling Windows</a>,
1695
for details.
1696
1697
<br><dt><samp><span class="option">--no-debugger-console</span></samp><dd>Do not open the debugger console upon start-up.
1698
1699
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1700
‘<samp><span class="samp">openDebuggerConsole</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Toggling-Windows">Toggling Windows</a>, for details.
1701
1702
<br><dt><samp><span class="option">--no-disassemble</span></samp><dd>Do not disassemble the source code.
1703
1704
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1705
‘<samp><span class="samp">disassemble</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Customizing-Source">Customizing Source</a>,
1706
for details.
1707
1708
<br><dt><samp><span class="option">--no-exec-window</span></samp><dd>Do not run the debugged program in a specially created execution window;
1736
1709
use the debugger console instead. Useful for programs that have little
1737
terminal input/output, or for remote debugging. See <a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>, for details.
1738
1739
<p>Giving this option is equivalent to setting the <small>DDD</small>
1740
<code>separateExecWindow</code> resource to <code>off</code>. See <a href="#Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>, for details.
1741
1742
<br><dt><code>--no-glyphs</code>
1743
<dd>Do not use glyphs; display the current execution position and
1710
terminal input/output, or for remote debugging. See <a href="#Using-the-Execution-Window">Using the Execution Window</a>, for details.
1711
1712
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1713
‘<samp><span class="samp">separateExecWindow</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Customizing-the-Execution-Window">Customizing the Execution Window</a>, for details.
1714
1715
<br><dt><samp><span class="option">--no-glyphs</span></samp><dd>Do not use glyphs; display the current execution position and
1744
1716
breakpoints as text characters.
1745
1717
1746
<p>Giving this option is equivalent to setting the <small>DDD</small>
1747
<code>displayGlyphs</code> resource to <code>off</code>. See <a href="#Customizing%20Source">Customizing Source</a>,
1748
for details.
1749
1750
<br><dt><code>--no-lesstif-hacks</code>
1751
<dd>Equivalent to <code>--lesstif-version 1000</code>. Deprecated.
1752
1753
<p>Giving this option is equivalent to setting the <small>DDD</small>
1754
<code>lessTifVersion</code> resource to <code>1000</code>. See <a href="#LessTif">LessTif</a>, for
1755
details.
1756
1757
<br><dt><code>--no-maintenance</code>
1758
<dd>Do not enable the top-level <code>Maintenance</code> menu with options for
1759
debugging <small>DDD</small>. This is the default. See <a href="#Maintenance%20Menu">Maintenance Menu</a>,
1760
for details.
1761
1762
<p>Giving this option is equivalent to setting the <small>DDD</small>
1763
<code>maintenance</code> resource to <var>off</var>. See <a href="#Maintenance%20Menu">Maintenance Menu</a>, for
1764
details.
1765
1766
<br><dt><code>--no-source-window</code>
1767
<dd>Do not open the source window upon start-up.
1768
1769
<p>Giving this option is equivalent to setting the <small>DDD</small>
1770
<code>openSourceWindow</code> resource to <code>off</code>. See <a href="#Toggling%20Windows">Toggling Windows</a>, for details.
1771
1772
<br><dt><code>--no-value-tips</code>
1773
<dd>Disable value tips.
1774
1775
<p>Giving this option is equivalent to setting the <small>DDD</small>
1776
<code>valueTips</code> resource to <code>off</code>. See <a href="#Value%20Tips">Value Tips</a>, for
1777
details.
1778
1779
<br><dt><code>--nw</code>
1780
<dd>Do not use the X window interface. Start the inferior debugger on
1718
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1719
‘<samp><span class="samp">displayGlyphs</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Customizing-Source">Customizing Source</a>,
1720
for details.
1721
1722
<br><dt><samp><span class="option">--no-lesstif-hacks</span></samp><dd>Equivalent to <samp><span class="option">--lesstif-version 1000</span></samp>. Deprecated.
1723
1724
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1725
‘<samp><span class="samp">lessTifVersion</span></samp>’ resource to <code>1000</code>. See <a href="#LessTif">LessTif</a>, for
1726
details.
1727
1728
<br><dt><samp><span class="option">--no-maintenance</span></samp><dd>Do not enable the top-level ‘<samp><span class="samp">Maintenance</span></samp>’ menu with options for
1729
debugging <acronym>DDD</acronym>. This is the default. See <a href="#Maintenance-Menu">Maintenance Menu</a>,
1730
for details.
1731
1732
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1733
‘<samp><span class="samp">maintenance</span></samp>’ resource to <var>off</var>. See <a href="#Maintenance-Menu">Maintenance Menu</a>, for
1734
details.
1735
1736
<br><dt><samp><span class="option">--no-source-window</span></samp><dd>Do not open the source window upon start-up.
1737
1738
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1739
‘<samp><span class="samp">openSourceWindow</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Toggling-Windows">Toggling Windows</a>, for details.
1740
1741
<br><dt><samp><span class="option">--no-value-tips</span></samp><dd>Disable value tips.
1742
1743
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1744
‘<samp><span class="samp">valueTips</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Value-Tips">Value Tips</a>, for
1745
details.
1746
1747
<br><dt><samp><span class="option">--nw</span></samp><dd>Do not use the X window interface. Start the inferior debugger on
1781
1748
the local host.
1782
1749
1783
<br><dt><code>--perl</code>
1784
<dd>Run Perl as inferior debugger.
1785
1786
<p>Giving this option is equivalent to setting the <small>DDD</small>
1787
<code>debugger</code> resource to <code>perl</code>. See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>,
1788
for details.
1789
1790
<br><dt><code>--pydb</code>
1791
<dd>Run <small>PYDB</small> as inferior debugger.
1792
1793
<p>Giving this option is equivalent to setting the <small>DDD</small>
1794
<code>debugger</code> resource to <code>pydb</code>. See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>,
1795
for details.
1796
1797
<br><dt><code>--panned-graph-editor</code>
1798
<dd>Use an Athena panner to scroll the data window. Most people prefer
1750
<br><dt><samp><span class="option">--perl</span></samp><dd>Run Perl as inferior debugger.
1751
1752
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1753
‘<samp><span class="samp">debugger</span></samp>’ resource to ‘<samp><span class="samp">perl</span></samp>’. See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>,
1754
for details.
1755
1756
<br><dt><samp><span class="option">--pydb</span></samp><dd>Run <code>pydb</code> as inferior debugger.
1757
1758
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1759
‘<samp><span class="samp">debugger</span></samp>’ resource to ‘<samp><span class="samp">pydb</span></samp>’. See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>,
1760
for details.
1761
1762
<br><dt><samp><span class="option">--panned-graph-editor</span></samp><dd>Use an Athena panner to scroll the data window. Most people prefer
1799
1763
panners on scroll bars, since panners allow two-dimensional scrolling.
1800
1764
However, the panner is off by default, since some M*tif implementations
1801
do not work well with Athena widgets. See <a href="#Display%20Resources">Display Resources</a>, for
1802
details; see also <code>--scrolled-graph-editor</code>, below.
1803
1804
<p>Giving this option is equivalent to setting the <small>DDD</small>
1805
<code>pannedGraphEditor</code> resource to <code>on</code>. See <a href="#Display%20Resources">Display Resources</a>, for details.
1806
1807
<br><dt><code>--play-log </code><var>log-file</var><code></code>
1808
<dd>Recapitulate a previous <small>DDD</small> session.
1765
do not work well with Athena widgets. See <a href="#Display-Resources">Display Resources</a>, for
1766
details; see also <samp><span class="option">--scrolled-graph-editor</span></samp>, below.
1767
1768
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1769
‘<samp><span class="samp">pannedGraphEditor</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Display-Resources">Display Resources</a>, for details.
1770
1771
<br><dt><samp><span class="option">--play-log </span><var>log-file</var></samp><dd>Recapitulate a previous <acronym>DDD</acronym> session.
1809
1772
1810
1773
<pre class="example"> ddd --play-log <var>log-file</var>
1811
</pre>
1812
1813
<p>invokes <small>DDD</small> as inferior debugger, simulating the inferior
1774
</pre>
1775
<p class="noindent">invokes <acronym>DDD</acronym> as inferior debugger, simulating the inferior
1814
1776
debugger given in <var>log-file</var> (see below). This is useful for
1815
debugging <small>DDD</small>.
1777
debugging <acronym>DDD</acronym>.
1816
1778
1817
<p>Giving this option is equivalent to setting the <small>DDD</small>
1818
<code>playLog</code> resource to <code>on</code>. See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>, for
1779
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1780
‘<samp><span class="samp">playLog</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>, for
1819
1781
details.
1820
1782
1821
<br><dt><code>--PLAY </code><var>log-file</var><code></code>
1822
<dd>Simulate an inferior debugger. <var>log-file</var> is a
1823
<code>~/.ddd/log</code> file as generated by some previous
1824
<small>DDD</small> session (see <a href="#Logging">Logging</a>). When a command is entered, scan
1783
<br><dt><samp><span class="option">--PLAY </span><var>log-file</var></samp><dd><a name="index-log-75"></a>Simulate an inferior debugger. <var>log-file</var> is a
1784
<samp><span class="file">~/.ddd/log</span></samp> file as generated by some previous
1785
<acronym>DDD</acronym> session (see <a href="#Logging">Logging</a>). When a command is entered, scan
1825
1786
<var>log-file</var> for this command and re-issue the logged reply; if the
1826
command is not found, do nothing. This is used by the <code>--play</code>
1787
command is not found, do nothing. This is used by the <samp><span class="option">--play</span></samp>
1827
1788
option.
1828
1789
1829
<br><dt><code>--rhost </code><var>hostname</var><code></code>
1830
<dd><dt><code>--rhost </code><var>username</var><code>@</code><var>hostname</var><code></code>
1831
<dd>Run the inferior debugger interactively on the remote host
1832
<var>hostname</var>. If <var>username</var> is given and the <code>--login</code>
1790
<br><dt><samp><span class="option">--rhost </span><var>hostname</var></samp><dt><samp><span class="option">--rhost </span><var>username</var><span class="option">@</span><var>hostname</var></samp><dd>Run the inferior debugger interactively on the remote host
1791
<var>hostname</var>. If <var>username</var> is given and the <samp><span class="option">--login</span></samp>
1833
1792
option is not used, use <var>username</var> as remote user name.
1834
See <a href="#Remote%20Debugger">Remote Debugger</a>, for details.
1835
1836
<p>Giving this option is equivalent to setting the <small>DDD</small>
1837
<code>debuggerRHost</code> resource to <var>hostname</var>. See <a href="#Remote%20Debugger">Remote Debugger</a>, for details.
1838
1839
<br><dt><code>--scrolled-graph-editor</code>
1840
<dd>Use M*tif scroll bars to scroll the data window. This is the default in
1841
most <small>DDD</small> configurations. See <a href="#Display%20Resources">Display Resources</a>, for details;
1842
see also <code>--panned-graph-editor</code>, above.
1843
1844
<p>Giving this option is equivalent to setting the <small>DDD</small>
1845
<code>pannedGraphEditor</code> resource to <code>off</code>. See <a href="#Display%20Resources">Display Resources</a>, for details.
1846
1847
<br><dt><code>--separate-windows</code>
1848
<dd><dt><code>--separate</code>
1849
<dd>Separate the console, source and data windows. See also the
1850
<code>--attach</code> options, above.
1851
1852
<p>Giving this option is equivalent to setting the <small>DDD</small>
1853
<code>Separate</code> resource class to <code>off</code>. See <a href="#Window%20Layout">Window Layout</a>, for
1854
details.
1855
1856
<br><dt><code>--session </code><var>session</var><code></code>
1857
<dd>Load <var>session</var> upon start-up. See <a href="#Resuming%20Sessions">Resuming Sessions</a>, for
1858
details.
1859
1860
<p>Giving this option is equivalent to setting the <small>DDD</small>
1861
<code>session</code> resource to <var>session</var>. See <a href="#Resuming%20Sessions">Resuming Sessions</a>, for
1862
details.
1863
1864
<br><dt><code>--source-window</code>
1865
<dd>Open the source window upon start-up.
1866
1867
<p>Giving this option is equivalent to setting the <small>DDD</small>
1868
<code>openSourceWindow</code> resource to <code>on</code>. See <a href="#Toggling%20Windows">Toggling Windows</a>,
1793
See <a href="#Remote-Debugger">Remote Debugger</a>, for details.
1794
1795
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1796
‘<samp><span class="samp">debuggerRHost</span></samp>’ resource to <var>hostname</var>. See <a href="#Remote-Debugger">Remote Debugger</a>, for details.
1797
1798
<br><dt><samp><span class="option">--scrolled-graph-editor</span></samp><dd>Use M*tif scroll bars to scroll the data window. This is the default in
1799
most <acronym>DDD</acronym> configurations. See <a href="#Display-Resources">Display Resources</a>, for details;
1800
see also <samp><span class="option">--panned-graph-editor</span></samp>, above.
1801
1802
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1803
‘<samp><span class="samp">pannedGraphEditor</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Display-Resources">Display Resources</a>, for details.
1804
1805
<br><dt><samp><span class="option">--separate-windows</span></samp><dt><samp><span class="option">--separate</span></samp><dd>Separate the console, source and data windows. See also the
1806
<samp><span class="option">--attach</span></samp> options, above.
1807
1808
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1809
‘<samp><span class="samp">Separate</span></samp>’ resource class to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Window-Layout">Window Layout</a>, for
1810
details.
1811
1812
<br><dt><samp><span class="option">--session </span><var>session</var></samp><dd><a name="index-Session_002c-setting-when-invoking-_0040DDD_007b_007d-76"></a>Load <var>session</var> upon start-up. See <a href="#Resuming-Sessions">Resuming Sessions</a>, for
1813
details.
1814
1815
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1816
‘<samp><span class="samp">session</span></samp>’ resource to <var>session</var>. See <a href="#Resuming-Sessions">Resuming Sessions</a>, for
1817
details.
1818
1819
<br><dt><samp><span class="option">--source-window</span></samp><dd>Open the source window upon start-up.
1820
1821
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1822
‘<samp><span class="samp">openSourceWindow</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Toggling-Windows">Toggling Windows</a>,
1869
1823
for details.
1870
1824
1871
<br><dt><code>--status-at-bottom</code>
1872
<dd>Place the status line at the bottom of the source window.
1873
1874
<p>Giving this option is equivalent to setting the <small>DDD</small>
1875
<code>statusAtBottom</code> resource to <code>on</code>. See <a href="#Window%20Layout">Window Layout</a>, for
1876
details.
1877
1878
<br><dt><code>--status-at-top</code>
1879
<dd>Place the status line at the top of the source window.
1880
1881
<p>Giving this option is equivalent to setting the <small>DDD</small>
1882
<code>statusAtBottom</code> resource to <code>off</code>. See <a href="#Window%20Layout">Window Layout</a>, for
1883
details.
1884
1885
<br><dt><code>--sync-debugger</code>
1886
<dd>Do not process X events while the debugger is busy. This may result
1825
<br><dt><samp><span class="option">--status-at-bottom</span></samp><dd>Place the status line at the bottom of the source window.
1826
1827
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1828
‘<samp><span class="samp">statusAtBottom</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Window-Layout">Window Layout</a>, for
1829
details.
1830
1831
<br><dt><samp><span class="option">--status-at-top</span></samp><dd>Place the status line at the top of the source window.
1832
1833
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1834
‘<samp><span class="samp">statusAtBottom</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Window-Layout">Window Layout</a>, for
1835
details.
1836
1837
<br><dt><samp><span class="option">--sync-debugger</span></samp><dd>Do not process X events while the debugger is busy. This may result
1887
1838
in slightly better performance on single-processor systems.
1888
1839
1889
<p>Giving this option is equivalent to setting the <small>DDD</small>
1890
<code>synchronousDebugger</code> resource to <code>on</code>. See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>, for details.
1891
1892
<br><dt><code>--toolbars-at-bottom</code>
1893
<dd>Place the toolbars at the bottom of the respective window.
1894
1895
<p>Giving this option is equivalent to setting the <small>DDD</small>
1896
<code>toolbarsAtBottom</code> resource to <code>on</code>. See <a href="#Window%20Layout">Window Layout</a>,
1897
for details.
1898
1899
<br><dt><code>--toolbars-at-top</code>
1900
<dd>Place the toolbars at the top of the respective window.
1901
1902
<p>Giving this option is equivalent to setting the <small>DDD</small>
1903
<code>toolbarsAtBottom</code> resource to <code>off</code>. See <a href="#Window%20Layout">Window Layout</a>,
1904
for details.
1905
1906
<br><dt><code>--trace</code>
1907
<dd>Show the interaction between <small>DDD</small> and the inferior debugger on
1908
standard error. This is useful for debugging <small>DDD</small>. If
1909
<code>--trace</code> is not specified, this information is written into
1910
<code>~/.ddd/log</code> (<code>~</code> stands for your home directory),
1840
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1841
‘<samp><span class="samp">synchronousDebugger</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>, for details.
1842
1843
<br><dt><samp><span class="option">--toolbars-at-bottom</span></samp><dd>Place the toolbars at the bottom of the respective window.
1844
1845
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1846
‘<samp><span class="samp">toolbarsAtBottom</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Window-Layout">Window Layout</a>,
1847
for details.
1848
1849
<br><dt><samp><span class="option">--toolbars-at-top</span></samp><dd>Place the toolbars at the top of the respective window.
1850
1851
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1852
‘<samp><span class="samp">toolbarsAtBottom</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’. See <a href="#Window-Layout">Window Layout</a>,
1853
for details.
1854
1855
<br><dt><samp><span class="option">--trace</span></samp><dd><a name="index-log-77"></a><a name="index-g_t_007e-78"></a>Show the interaction between <acronym>DDD</acronym> and the inferior debugger on
1856
standard error. This is useful for debugging <acronym>DDD</acronym>. If
1857
<samp><span class="option">--trace</span></samp> is not specified, this information is written into
1858
<samp><span class="file">~/.ddd/log</span></samp> (<samp><span class="file">~</span></samp> stands for your home directory),
1911
1859
such that you can also do a post-mortem debugging. See <a href="#Logging">Logging</a>, for
1912
1860
details about logging.
1913
1861
1914
<p>Giving this option is equivalent to setting the <small>DDD</small> <code>trace</code>
1862
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym> ‘<samp><span class="samp">trace</span></samp>’
1915
1863
resource to <var>on</var>. See <a href="#Diagnostics">Diagnostics</a>, for details.
1916
1864
1917
<br><dt><code>--tty</code>
1918
<dd><dt><code>-t</code>
1919
<dd>Enable <small>TTY</small> interface, taking additional debugger commands from
1865
<br><dt><samp><span class="option">--tty</span></samp><dt><samp><span class="option">-t</span></samp><dd><a name="index-g_t_0040acronym_007bTTY_007d-mode_002c-setting-when-invoking-_0040DDD_007b_007d-79"></a>Enable <acronym>TTY</acronym> interface, taking additional debugger commands from
1920
1866
standard input and forwarding debugger output on standard output.
1921
1867
Current positions are issued in a format readable for humans. By
1922
1868
default, the debugger console is disabled.
1923
1869
1924
<p>Giving this option is equivalent to setting the <small>DDD</small>
1925
<code>ttyMode</code> resource to <code>on</code>. See <a href="#TTY%20mode">TTY mode</a>, for details.
1926
1927
<br><dt><code>--value-tips</code>
1928
<dd>Enable value tips.
1929
1930
<p>Giving this option is equivalent to setting the <small>DDD</small>
1931
<code>valueTips</code> resource to <code>on</code>. See <a href="#Value%20Tips">Value Tips</a>, for details.
1932
1933
<br><dt><code>--version</code>
1934
<dd><dt><code>-v</code>
1935
<dd>Print the <small>DDD</small> version on standard output and exit.
1936
1937
<p>Giving this option is equivalent to setting the <small>DDD</small>
1938
<code>showVersion</code> resource to <code>on</code>. See <a href="#Diagnostics">Diagnostics</a>, for
1870
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1871
‘<samp><span class="samp">ttyMode</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#TTY-mode">TTY mode</a>, for details.
1872
1873
<br><dt><samp><span class="option">--value-tips</span></samp><dd>Enable value tips.
1874
1875
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1876
‘<samp><span class="samp">valueTips</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Value-Tips">Value Tips</a>, for details.
1877
1878
<br><dt><samp><span class="option">--version</span></samp><dt><samp><span class="option">-v</span></samp><dd>Print the <acronym>DDD</acronym> version on standard output and exit.
1879
1880
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1881
‘<samp><span class="samp">showVersion</span></samp>’ resource to ‘<samp><span class="samp">on</span></samp>’. See <a href="#Diagnostics">Diagnostics</a>, for
1939
1882
details.
1940
1883
1941
<br><dt><code>--vsl-library </code><var>library</var><code></code>
1942
<dd>Load the <small>VSL</small> library <var>library</var> instead of using the
1943
<small>DDD</small> built-in library. This is useful for customizing
1884
<br><dt><samp><span class="option">--vsl-library </span><var>library</var></samp><dd>Load the <acronym>VSL</acronym> library <var>library</var> instead of using the
1885
<acronym>DDD</acronym> built-in library. This is useful for customizing
1944
1886
display shapes and fonts.
1945
1887
1946
<p>Giving this option is equivalent to setting the <small>DDD</small> <code>vslLibrary</code>
1947
resource to <var>library</var>. See <a href="#VSL%20Resources">VSL Resources</a>, for details.
1948
1949
<br><dt><code>--vsl-path </code><var>path</var><code></code>
1950
<dd>Search <small>VSL</small> libraries in <var>path</var> (a colon-separated directory list).
1951
1952
<p>Giving this option is equivalent to setting the <small>DDD</small> <code>vslPath</code>
1953
resource to <var>path</var>. See <a href="#VSL%20Resources">VSL Resources</a>, for details.
1954
1955
<br><dt><code>--vsl-help</code>
1956
<dd>Show a list of further options controlling the <small>VSL</small> interpreter. These
1888
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym> ‘<samp><span class="samp">vslLibrary</span></samp>’
1889
resource to <var>library</var>. See <a href="#VSL-Resources">VSL Resources</a>, for details.
1890
1891
<br><dt><samp><span class="option">--vsl-path </span><var>path</var></samp><dd>Search <acronym>VSL</acronym> libraries in <var>path</var> (a colon-separated directory list).
1892
1893
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym> ‘<samp><span class="samp">vslPath</span></samp>’
1894
resource to <var>path</var>. See <a href="#VSL-Resources">VSL Resources</a>, for details.
1895
1896
<br><dt><samp><span class="option">--vsl-help</span></samp><dd>Show a list of further options controlling the <acronym>VSL</acronym> interpreter. These
1957
1897
options are intended for debugging purposes and are subject to change
1958
1898
without further notice.
1959
1899
1960
<br><dt><code>--wdb</code>
1961
<dd>Run <small>WDB</small> as inferior debugger.
1962
1963
<p>Giving this option is equivalent to setting the <small>DDD</small>
1964
<code>debugger</code> resource to <code>wdb</code>. See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>, for details.
1965
1966
<br><dt><code>--xdb</code>
1967
<dd>Run <small>XDB</small> as inferior debugger.
1968
1969
<p>Giving this option is equivalent to setting the <small>DDD</small>
1970
<code>debugger</code> resource to <code>xdb</code>. See <a href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>, for details.
1900
<br><dt><samp><span class="option">--wdb</span></samp><dd>Run <acronym>WDB</acronym> as inferior debugger.
1901
1902
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1903
‘<samp><span class="samp">debugger</span></samp>’ resource to ‘<samp><span class="samp">wdb</span></samp>’. See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>, for details.
1904
1905
<br><dt><samp><span class="option">--xdb</span></samp><dd>Run <acronym>XDB</acronym> as inferior debugger.
1906
1907
<p>Giving this option is equivalent to setting the <acronym>DDD</acronym>
1908
‘<samp><span class="samp">debugger</span></samp>’ resource to ‘<samp><span class="samp">xdb</span></samp>’. See <a href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>, for details.
1971
1909
</dl>
1972
1910
1973
1911
<div class="node">
1974
1912
<p><hr>
1975
<small class=header>
1976
Node:<a name="X%20Options">X Options</a>,
1977
Next:<a rel="next" accesskey="n" href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>,
1978
Previous:<a rel="previous" accesskey="p" href="#Options">Options</a>,
1979
Up:<a rel="up" accesskey="u" href="#Invoking">Invoking</a>
1913
<a name="X-Options"></a>
1914
Next: <a rel="next" accesskey="n" href="#Inferior-Debugger-Options">Inferior Debugger Options</a>,
1915
Previous: <a rel="previous" accesskey="p" href="#Options">Options</a>,
1916
Up: <a rel="up" accesskey="u" href="#Invoking">Invoking</a>
1980
1917
</small>
1981
1918
1982
<br>
1919
1983
1920
</div>
1984
1921
1985
<h4 class="subsection">X Options</h4>
1922
<h4 class="subsection">2.1.3 X Options</h4>
1986
1923
1987
<p><small>DDD</small> also understands the following X options. Note that these
1988
options only take a single dash <code>-</code>.
1924
<p><acronym>DDD</acronym> also understands the following X options. Note that these
1925
options only take a single dash <samp><span class="option">-</span></samp>.
1989
1926
1990
1927
<dl>
1991
<dt><code>-display </code><var>display</var><code></code>
1992
<dd>Use the X server <var>display</var>. By default, <var>display</var> is taken from
1993
the <code>DISPLAY</code> environment variable.
1994
1995
<br><dt><code>-geometry </code><var>geometry</var><code></code>
1996
<dd>Specify the initial size and location of the debugger console.
1997
1998
<br><dt><code>-iconic</code>
1999
<dd>Start <small>DDD</small> iconified.
2000
2001
<br><dt><code>-name </code><var>name</var><code></code>
2002
<dd>Give <small>DDD</small> the name <var>name</var>.
2003
2004
<br><dt><code>-selectionTimeout </code><var>timeout</var><code></code>
2005
<dd>Specify the timeout in milliseconds within which two communicating
1928
<dt><samp><span class="option">-display </span><var>display</var></samp><dd><a name="index-Display_002c-setting-when-invoking-_0040DDD_007b_007d-80"></a><a name="index-DISPLAY-81"></a>Use the X server <var>display</var>. By default, <var>display</var> is taken from
1929
the <samp><span class="env">DISPLAY</span></samp> environment variable.
1930
1931
<br><dt><samp><span class="option">-geometry </span><var>geometry</var></samp><dd>Specify the initial size and location of the debugger console.
1932
1933
<br><dt><samp><span class="option">-iconic</span></samp><dd><a name="index-Icon_002c-invoking-_0040DDD_007b_007d-as-82"></a>Start <acronym>DDD</acronym> iconified.
1934
1935
<br><dt><samp><span class="option">-name </span><var>name</var></samp><dd>Give <acronym>DDD</acronym> the name <var>name</var>.
1936
1937
<br><dt><samp><span class="option">-selectionTimeout </span><var>timeout</var></samp><dd>Specify the timeout in milliseconds within which two communicating
2006
1938
applications must respond to one another for a selection request.
2007
1939
2008
<br><dt><code>-title </code><var>name</var><code></code>
2009
<dd>Give the <small>DDD</small> window the title <var>name</var>.
1940
<br><dt><samp><span class="option">-title </span><var>name</var></samp><dd>Give the <acronym>DDD</acronym> window the title <var>name</var>.
2010
1941
2011
<br><dt><code>-xrm </code><var>resourcestring</var><code></code>
2012
<dd>Specify a resource name and value to override any defaults.
2013
</dl>
1942
<br><dt><samp><span class="option">-xrm </span><var>resourcestring</var></samp><dd>Specify a resource name and value to override any defaults.
1943
<a name="index-Resource_002c-setting-when-invoking-_0040DDD_007b_007d-83"></a></dl>
2014
1944
2015
1945
<div class="node">
2016
1946
<p><hr>
2017
<small class=header>
2018
Node:<a name="Inferior%20Debugger%20Options">Inferior Debugger Options</a>,
2019
Next:<a rel="next" accesskey="n" href="#Multiple%20Instances">Multiple Instances</a>,
2020
Previous:<a rel="previous" accesskey="p" href="#X%20Options">X Options</a>,
2021
Up:<a rel="up" accesskey="u" href="#Invoking">Invoking</a>
1947
<a name="Inferior-Debugger-Options"></a>
1948
Next: <a rel="next" accesskey="n" href="#Multiple-Instances">Multiple Instances</a>,
1949
Previous: <a rel="previous" accesskey="p" href="#X-Options">X Options</a>,
1950
Up: <a rel="up" accesskey="u" href="#Invoking">Invoking</a>
2022
1951
</small>
2023
1952
2024
<br>
1953
2025
1954
</div>
2026
1955
2027
<h4 class="subsection">Inferior Debugger Options</h4>
1956
<h4 class="subsection">2.1.4 Inferior Debugger Options</h4>
2028
1957
2029
<p>All options that <small>DDD</small> does not recognize are passed to the inferior
1958
<p>All options that <acronym>DDD</acronym> does not recognize are passed to the inferior
2030
1959
debugger. This section lists the most useful options of the different
2031
inferior debuggers supported by <small>DDD</small>. In case these options do not
1960
inferior debuggers supported by <acronym>DDD</acronym>. In case these options do not
2032
1961
work as expected, please lookup the appropriate reference.
2033
1962
2034
1963
<ul class="menu">
2035
<li><a accesskey="1" href="#GDB%20Options">GDB Options</a>:
2036
<li><a accesskey="2" href="#DBX%20and%20Ladebug%20Options">DBX and Ladebug Options</a>:
2037
<li><a accesskey="3" href="#XDB%20Options">XDB Options</a>:
2038
<li><a accesskey="4" href="#JDB%20Options">JDB Options</a>:
2039
<li><a accesskey="5" href="#PYDB%20Options">PYDB Options</a>:
2040
<li><a accesskey="6" href="#Perl%20Options">Perl Options</a>:
2041
<li><a accesskey="7" href="#Bash%20Options">Bash Options</a>:
1964
<li><a accesskey="1" href="#GDB-Options">GDB Options</a>
1965
<li><a accesskey="2" href="#DBX-and-Ladebug-Options">DBX and Ladebug Options</a>
1966
<li><a accesskey="3" href="#XDB-Options">XDB Options</a>
1967
<li><a accesskey="4" href="#JDB-Options">JDB Options</a>
1968
<li><a accesskey="5" href="#Bash-Options">Bash Options</a>
1969
<li><a accesskey="6" href="#GNU-Make-Options">GNU Make Options</a>
1970
<li><a accesskey="7" href="#Perl-Options">Perl Options</a>
1971
<li><a accesskey="8" href="#PYDB-Options">PYDB Options</a>
2042
1972
</ul>
2043
1973
2044
1974
<div class="node">
2045
1975
<p><hr>
2046
<small class=header>
2047
Node:<a name="GDB%20Options">GDB Options</a>,
2048
Next:<a rel="next" accesskey="n" href="#DBX%20and%20Ladebug%20Options">DBX and Ladebug Options</a>,
2049
Up:<a rel="up" accesskey="u" href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>
1976
<a name="GDB-Options"></a>
1977
Next: <a rel="next" accesskey="n" href="#DBX-and-Ladebug-Options">DBX and Ladebug Options</a>,
1978
Up: <a rel="up" accesskey="u" href="#Inferior-Debugger-Options">Inferior Debugger Options</a>
2050
1979
</small>
2051
1980
2052
<br>
1981
2053
1982
</div>
2054
1983
2055
<h5 class="subsubsection">GDB Options</h5>
1984
<h5 class="subsubsection">2.1.4.1 GDB Options</h5>
2056
1985
2057
<p>These <small>GDB</small> options are useful when using <small>DDD</small> with <small>GDB</small> as inferior
2058
debugger. Single dashes <code>-</code> instead of double dashes <code>--</code> may
1986
<p>These <acronym>GDB</acronym> options are useful when using <acronym>DDD</acronym> with <acronym>GDB</acronym> as inferior
1987
debugger. Single dashes <samp><span class="option">-</span></samp> instead of double dashes <samp><span class="option">--</span></samp> may
2059
1988
also be used.
2060
1989
2061
1990
<dl>
2062
<dt><code>-b </code><var>baudrate</var><code></code>
2063
<dd>Set serial port baud rate used for remote debugging.
2064
2065
<br><dt><code>--cd </code><var>dir</var><code></code>
2066
<dd>Change current directory to <var>dir</var>.
2067
2068
<br><dt><code>--command </code><var>file</var><code></code>
2069
<dd>Execute <small>GDB</small> commands from <var>file</var>.
2070
2071
<br><dt><code>--core </code><var>corefile</var><code></code>
2072
<dd>Analyze the core dump <var>corefile</var>.
2073
2074
<br><dt><code>--directory </code><var>dir</var><code></code>
2075
<dd><dt><code>-d </code><var>dir</var><code></code>
2076
<dd>Add <var>directory</var> to the path to search for source files.
2077
2078
<br><dt><code>--exec </code><var>execfile</var><code></code>
2079
<dd>Use <var>execfile</var> as the executable.
2080
2081
<br><dt><code>--mapped</code>
2082
<dd>Use mapped symbol files if supported on this system.
2083
2084
<br><dt><code>--nx</code>
2085
<dd><br><dt><code>-n</code>
2086
<dd>Do not read <code>.gdbinit</code> file.
2087
2088
<br><dt><code>--readnow</code>
2089
<dd>Fully read symbol files on first access.
2090
2091
<br><dt><code>--se </code><var>file</var><code></code>
2092
<dd>Use <var>file</var> as symbol file and executable file.
2093
2094
<br><dt><code>--symbols </code><var>symfile</var><code></code>
2095
<dd>Read symbols from <var>symfile</var>.
1991
<dt><samp><span class="option">-b </span><var>baudrate</var></samp><dd>Set serial port baud rate used for remote debugging.
1992
1993
<br><dt><samp><span class="option">--cd </span><var>dir</var></samp><dd>Change current directory to <var>dir</var>.
1994
1995
<br><dt><samp><span class="option">--command </span><var>file</var></samp><dd>Execute <acronym>GDB</acronym> commands from <var>file</var>.
1996
1997
<br><dt><samp><span class="option">--core </span><var>corefile</var></samp><dd>Analyze the core dump <var>corefile</var>.
1998
1999
<br><dt><samp><span class="option">--directory </span><var>dir</var></samp><dt><samp><span class="option">-d </span><var>dir</var></samp><dd>Add <var>directory</var> to the path to search for source files.
2000
2001
<br><dt><samp><span class="option">--exec </span><var>execfile</var></samp><dd>Use <var>execfile</var> as the executable.
2002
2003
<br><dt><samp><span class="option">--mapped</span></samp><dd>Use mapped symbol files if supported on this system.
2004
2005
<br><dt><samp><span class="option">--nx</span></samp><br><dt><samp><span class="option">-n</span></samp><dd><a name="index-g_t_002egdbinit-84"></a>Do not read <samp><span class="file">.gdbinit</span></samp> file.
2006
2007
<br><dt><samp><span class="option">--readnow</span></samp><dd>Fully read symbol files on first access.
2008
2009
<br><dt><samp><span class="option">--se </span><var>file</var></samp><dd>Use <var>file</var> as symbol file and executable file.
2010
2011
<br><dt><samp><span class="option">--symbols </span><var>symfile</var></samp><dd>Read symbols from <var>symfile</var>.
2096
2012
</dl>
2097
2013
2098
<p>See <a href="gdb.html#Invoking%20GDB">Invoking GDB</a>, for further options that can be used with <small>GDB</small>.
2014
<p>See <a href="gdb.html#Invoking-GDB">Invoking GDB</a>, for further options that can be used with <acronym>GDB</acronym>.
2099
2015
2100
2016
<div class="node">
2101
2017
<p><hr>
2102
<small class=header>
2103
Node:<a name="DBX%20and%20Ladebug%20Options">DBX and Ladebug Options</a>,
2104
Next:<a rel="next" accesskey="n" href="#XDB%20Options">XDB Options</a>,
2105
Previous:<a rel="previous" accesskey="p" href="#GDB%20Options">GDB Options</a>,
2106
Up:<a rel="up" accesskey="u" href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>
2018
<a name="DBX-and-Ladebug-Options"></a>
2019
Next: <a rel="next" accesskey="n" href="#XDB-Options">XDB Options</a>,
2020
Previous: <a rel="previous" accesskey="p" href="#GDB-Options">GDB Options</a>,
2021
Up: <a rel="up" accesskey="u" href="#Inferior-Debugger-Options">Inferior Debugger Options</a>
2107
2022
</small>
2108
2023
2109
<br>
2024
2110
2025
</div>
2111
2026
2112
<h5 class="subsubsection">DBX and Ladebug Options</h5>
2027
<h5 class="subsubsection">2.1.4.2 DBX and Ladebug Options</h5>
2113
2028
2114
<p><small>DBX</small> variants differ widely in their options, so we cannot give a list
2029
<p><acronym>DBX</acronym> variants differ widely in their options, so we cannot give a list
2115
2030
here. Check out the <cite>dbx(1)</cite> and <cite>ladebug(1)</cite> manual pages.
2116
2031
2117
2032
<div class="node">
2118
2033
<p><hr>
2119
<small class=header>
2120
Node:<a name="XDB%20Options">XDB Options</a>,
2121
Next:<a rel="next" accesskey="n" href="#JDB%20Options">JDB Options</a>,
2122
Previous:<a rel="previous" accesskey="p" href="#DBX%20and%20Ladebug%20Options">DBX and Ladebug Options</a>,
2123
Up:<a rel="up" accesskey="u" href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>
2034
<a name="XDB-Options"></a>
2035
Next: <a rel="next" accesskey="n" href="#JDB-Options">JDB Options</a>,
2036
Previous: <a rel="previous" accesskey="p" href="#DBX-and-Ladebug-Options">DBX and Ladebug Options</a>,
2037
Up: <a rel="up" accesskey="u" href="#Inferior-Debugger-Options">Inferior Debugger Options</a>
2124
2038
</small>
2125
2039
2126
<br>
2040
2127
2041
</div>
2128
2042
2129
<h5 class="subsubsection">XDB Options</h5>
2043
<h5 class="subsubsection">2.1.4.3 XDB Options</h5>
2130
2044
2131
<p>These <small>XDB</small> options are useful when using <small>DDD</small> with <small>XDB</small> as inferior
2045
<p>These <acronym>XDB</acronym> options are useful when using <acronym>DDD</acronym> with <acronym>XDB</acronym> as inferior
2132
2046
debugger.
2133
2047
2134
2048
<dl>
2135
<dt><code>-d </code><var>dir</var><code></code>
2136
<dd>Specify <var>dir</var> as an alternate directory where source files are
2049
<dt><samp><span class="option">-d </span><var>dir</var></samp><dd>Specify <var>dir</var> as an alternate directory where source files are
2137
2050
located.
2138
2051
2139
<br><dt><code>-P </code><var>process-id</var><code></code>
2140
<dd>Specify the process ID of an existing process the user wants to debug.
2141
2142
<br><dt><code>-l </code><var>library</var><code></code>
2143
<dd>Pre-load information about the shared library <var>library</var>. <code>-l
2144
ALL</code> means always pre-load shared library information.
2145
2146
<br><dt><code>-S </code><var>num</var><code></code>
2147
<dd>Set the size of the string cache to <var>num</var> bytes (default is 1024,
2052
<br><dt><samp><span class="option">-P </span><var>process-id</var></samp><dd>Specify the process ID of an existing process the user wants to debug.
2053
2054
<br><dt><samp><span class="option">-l </span><var>library</var></samp><dd>Pre-load information about the shared library <var>library</var>. <samp><span class="option">-l
2055
ALL</span></samp> means always pre-load shared library information.
2056
2057
<br><dt><samp><span class="option">-S </span><var>num</var></samp><dd>Set the size of the string cache to <var>num</var> bytes (default is 1024,
2148
2058
which is also the minimum).
2149
2059
2150
<br><dt><code>-s</code>
2151
<dd>Enable debugging of shared libraries.
2060
<br><dt><samp><span class="option">-s</span></samp><dd>Enable debugging of shared libraries.
2152
2061
</dl>
2153
2062
2154
2063
<p>Further options can be found in the <cite>xdb(1)</cite> manual page.
2155
2064
2156
2065
<div class="node">
2157
2066
<p><hr>
2158
<small class=header>
2159
Node:<a name="JDB%20Options">JDB Options</a>,
2160
Next:<a rel="next" accesskey="n" href="#PYDB%20Options">PYDB Options</a>,
2161
Previous:<a rel="previous" accesskey="p" href="#XDB%20Options">XDB Options</a>,
2162
Up:<a rel="up" accesskey="u" href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>
2067
<a name="JDB-Options"></a>
2068
Next: <a rel="next" accesskey="n" href="#Bash-Options">Bash Options</a>,
2069
Previous: <a rel="previous" accesskey="p" href="#XDB-Options">XDB Options</a>,
2070
Up: <a rel="up" accesskey="u" href="#Inferior-Debugger-Options">Inferior Debugger Options</a>
2163
2071
</small>
2164
2072
2165
<br>
2073
2166
2074
</div>
2167
2075
2168
<h5 class="subsubsection">JDB Options</h5>
2076
<h5 class="subsubsection">2.1.4.4 JDB Options</h5>
2169
2077
2170
2078
<h5 class="subsubheading">JDB as of JDK 1.2</h5>
2171
2079
2172
<p>The following <small>JDB</small> options are useful when using <small>DDD</small> with <small>JDB</small>
2173
(from <small>JDK</small> 1.2) as inferior debugger.
2080
<p>The following <acronym>JDB</acronym> options are useful when using <acronym>DDD</acronym> with <acronym>JDB</acronym>
2081
(from <acronym>JDK</acronym> 1.2) as inferior debugger.
2174
2082
2175
2083
<dl>
2176
<dt><code>-attach </code><var>address</var><code></code>
2177
<dd>attach to a running virtual machine (VM)
2084
<dt><samp><span class="option">-attach </span><var>address</var></samp><dd><a name="index-VM-85"></a><a name="index-virtual-machine-86"></a>attach to a running virtual machine (VM)
2178
2085
at <var>address</var> using standard connector
2179
2086
2180
<br><dt><code>-listen </code><var>address</var><code></code>
2181
<dd>wait for a running VM to connect at <var>address</var> using standard connector
2087
<br><dt><samp><span class="option">-listen </span><var>address</var></samp><dd>wait for a running VM to connect at <var>address</var> using standard connector
2182
2088
2183
<br><dt><code>-listenany</code>
2184
<dd>wait for a running VM to connect at any available address using
2089
<br><dt><samp><span class="option">-listenany</span></samp><dd>wait for a running VM to connect at any available address using
2185
2090
standard connector
2186
2091
2187
<br><dt><code>-launch</code>
2188
<dd>launch VM immediately instead of waiting for <code>run</code> command
2092
<br><dt><samp><span class="option">-launch</span></samp><dd>launch VM immediately instead of waiting for ‘<samp><span class="samp">run</span></samp>’ command
2189
2093
</dl>
2190
2094
2191
<p>These <small>JDB</small> options are forwarded to the debuggee:
2095
<p>These <acronym>JDB</acronym> options are forwarded to the debuggee:
2192
2096
2193
2097
<dl>
2194
<dt><code>-verbose[:class|gc|jni]</code>
2195
<dd><dt><code>-v</code>
2196
<dd>Turn on verbose mode.
2197
2198
<br><dt><code>-D</code><var>name</var><code>=</code><var>value</var><code></code>
2199
<dd>Set the system property <var>name</var> to <var>value</var>.
2200
2201
<br><dt><code>-classpath </code><var>path</var><code></code>
2202
<dd>List directories in which to look for classes. <var>path</var> is a list of
2098
<dt><samp><span class="option">-verbose[:class|gc|jni]</span></samp><dt><samp><span class="option">-v</span></samp><dd>Turn on verbose mode.
2099
2100
<br><dt><samp><span class="option">-D</span><var>name</var><span class="option">=</span><var>value</var></samp><dd>Set the system property <var>name</var> to <var>value</var>.
2101
2102
<br><dt><samp><span class="option">-classpath </span><var>path</var></samp><dd>List directories in which to look for classes. <var>path</var> is a list of
2203
2103
directories separated by colons.
2204
2104
2205
<br><dt><code>-X </code><var>option</var><code></code>
2206
<dd>Non-standard target VM option
2105
<br><dt><samp><span class="option">-X </span><var>option</var></samp><dd>Non-standard target VM option
2207
2106
</dl>
2208
2107
2209
2108
<h5 class="subsubheading">JDB as of JDK 1.1</h5>
2210
2109
2211
<p>The following <small>JDB</small> options are useful when using <small>DDD</small> with <small>JDB</small>
2212
(from <small>JDK</small> 1.1) as inferior debugger.
2110
<p>The following <acronym>JDB</acronym> options are useful when using <acronym>DDD</acronym> with <acronym>JDB</acronym>
2111
(from <acronym>JDK</acronym> 1.1) as inferior debugger.
2213
2112
2214
2113
<dl>
2215
<dt><code>-host </code><var>hostname</var><code></code>
2216
<dd>host machine of interpreter to attach to
2114
<dt><samp><span class="option">-host </span><var>hostname</var></samp><dd>host machine of interpreter to attach to
2217
2115
2218
<br><dt><code>-password </code><var>psswd</var><code></code>
2219
<dd>password of interpreter to attach to (from <code>-debug</code>)
2116
<br><dt><samp><span class="option">-password </span><var>psswd</var></samp><dd>password of interpreter to attach to (from <samp><span class="option">-debug</span></samp>)
2220
2117
</dl>
2221
2118
2222
<p>These <small>JDB</small> options are forwarded to the debuggee:
2119
<p>These <acronym>JDB</acronym> options are forwarded to the debuggee:
2223
2120
2224
2121
<dl>
2225
<dt><code>-verbose</code>
2226
<dd><dt><code>-v</code>
2227
<dd>Turn on verbose mode.
2228
2229
<br><dt><code>-debug</code>
2230
<dd>Enable remote Java debugging,
2231
2232
<br><dt><code>-noasyncgc</code>
2233
<dd>Don't allow asynchronous garbage collection.
2234
2235
<br><dt><code>-verbosegc</code>
2236
<dd>Print a message when garbage collection occurs.
2237
2238
<br><dt><code>-noclassgc</code>
2239
<dd>Disable class garbage collection.
2240
2241
<br><dt><code>-checksource</code>
2242
<dd><dt><code>-cs</code>
2243
<dd>Check if source is newer when loading classes.
2244
2245
<br><dt><code>-ss </code><var>number</var><code></code>
2246
<dd>Set the maximum native stack size for any thread.
2247
2248
<br><dt><code>-oss </code><var>number</var><code></code>
2249
<dd>Set the maximum Java stack size for any thread.
2250
2251
<br><dt><code>-ms </code><var>number</var><code></code>
2252
<dd>Set the initial Java heap size.
2253
2254
<br><dt><code>-mx </code><var>number</var><code></code>
2255
<dd>Set the maximum Java heap size.
2256
2257
<br><dt><code>-D</code><var>name</var><code>=</code><var>value</var><code></code>
2258
<dd>Set the system property <var>name</var> to <var>value</var>.
2259
2260
<br><dt><code>-classpath </code><var>path</var><code></code>
2261
<dd>List directories in which to look for classes. <var>path</var> is a list of
2122
<dt><samp><span class="option">-verbose</span></samp><dt><samp><span class="option">-v</span></samp><dd>Turn on verbose mode.
2123
2124
<br><dt><samp><span class="option">-debug</span></samp><dd>Enable remote Java debugging,
2125
2126
<br><dt><samp><span class="option">-noasyncgc</span></samp><dd>Don't allow asynchronous garbage collection.
2127
2128
<br><dt><samp><span class="option">-verbosegc</span></samp><dd>Print a message when garbage collection occurs.
2129
2130
<br><dt><samp><span class="option">-noclassgc</span></samp><dd>Disable class garbage collection.
2131
2132
<br><dt><samp><span class="option">-checksource</span></samp><dt><samp><span class="option">-cs</span></samp><dd>Check if source is newer when loading classes.
2133
2134
<br><dt><samp><span class="option">-ss </span><var>number</var></samp><dd>Set the maximum native stack size for any thread.
2135
2136
<br><dt><samp><span class="option">-oss </span><var>number</var></samp><dd>Set the maximum Java stack size for any thread.
2137
2138
<br><dt><samp><span class="option">-ms </span><var>number</var></samp><dd>Set the initial Java heap size.
2139
2140
<br><dt><samp><span class="option">-mx </span><var>number</var></samp><dd>Set the maximum Java heap size.
2141
2142
<br><dt><samp><span class="option">-D</span><var>name</var><span class="option">=</span><var>value</var></samp><dd>Set the system property <var>name</var> to <var>value</var>.
2143
2144
<br><dt><samp><span class="option">-classpath </span><var>path</var></samp><dd>List directories in which to look for classes. <var>path</var> is a list of
2262
2145
directories separated by colons.
2263
2146
2264
<br><dt><code>-prof</code>
2265
<dd><dt><code>-prof:</code><var>file</var><code></code>
2266
<dd>Output profiling data to <code>./java.prof</code>. If <var>file</var> is given,
2267
write the data to <code>./</code><var>file</var><code></code>.
2268
2269
<br><dt><code>-verify</code>
2270
<dd>Verify all classes when read in.
2271
2272
<br><dt><code>-verifyremote</code>
2273
<dd>Verify classes read in over the network (default).
2274
2275
<br><dt><code>-noverify</code>
2276
<dd>Do not verify any class.
2277
2278
<br><dt><code>-dbgtrace</code>
2279
<dd>Print info for debugging <small>JDB</small>.
2147
<br><dt><samp><span class="option">-prof</span></samp><dt><samp><span class="option">-prof:</span><var>file</var></samp><dd><a name="index-java_002eprof-87"></a>Output profiling data to <samp><span class="file">./java.prof</span></samp>. If <var>file</var> is given,
2148
write the data to <samp><span class="file">./</span><var>file</var></samp>.
2149
2150
<br><dt><samp><span class="option">-verify</span></samp><dd>Verify all classes when read in.
2151
2152
<br><dt><samp><span class="option">-verifyremote</span></samp><dd>Verify classes read in over the network (default).
2153
2154
<br><dt><samp><span class="option">-noverify</span></samp><dd>Do not verify any class.
2155
2156
<br><dt><samp><span class="option">-dbgtrace</span></samp><dd>Print info for debugging <acronym>JDB</acronym>.
2280
2157
</dl>
2281
2158
2282
<p>Further options can be found in the <small>JDB</small> documentation.
2283
2284
<div class="node">
2285
<p><hr>
2286
<small class=header>
2287
Node:<a name="PYDB%20Options">PYDB Options</a>,
2288
Next:<a rel="next" accesskey="n" href="#Perl%20Options">Perl Options</a>,
2289
Previous:<a rel="previous" accesskey="p" href="#JDB%20Options">JDB Options</a>,
2290
Up:<a rel="up" accesskey="u" href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>
2291
</small>
2292
2293
<br>
2294
</div>
2295
2296
<h5 class="subsubsection">PYDB Options</h5>
2297
2298
<p>For a list of useful <small>PYDB</small> options, check out the <small>PYDB</small> documentation.
2299
2300
<div class="node">
2301
<p><hr>
2302
<small class=header>
2303
Node:<a name="Perl%20Options">Perl Options</a>,
2304
Next:<a rel="next" accesskey="n" href="#Bash%20Options">Bash Options</a>,
2305
Previous:<a rel="previous" accesskey="p" href="#PYDB%20Options">PYDB Options</a>,
2306
Up:<a rel="up" accesskey="u" href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>
2307
</small>
2308
2309
<br>
2310
</div>
2311
2312
<h5 class="subsubsection">Perl Options</h5>
2313
2314
<p>The most important Perl option to use with <small>DDD</small> is <code>-w</code>; it
2159
<p>Further options can be found in the <acronym>JDB</acronym> documentation.
2160
2161
<div class="node">
2162
<p><hr>
2163
<a name="Bash-Options"></a>
2164
Next: <a rel="next" accesskey="n" href="#GNU-Make-Options">GNU Make Options</a>,
2165
Previous: <a rel="previous" accesskey="p" href="#JDB-Options">JDB Options</a>,
2166
Up: <a rel="up" accesskey="u" href="#Inferior-Debugger-Options">Inferior Debugger Options</a>
2167
</small>
2168
2169
2170
</div>
2171
2172
<h5 class="subsubsection">2.1.4.5 Bash Options</h5>
2173
2174
<p>If you have the proper bash installed, the option needed to specify
2175
debugging support is <samp><span class="option">--debugger</span></samp>. If your bash doesn't
2176
understand this option you need to pick up a version of bash that does
2177
from <a href="http://bashdb.sourceforge.net">http://bashdb.sourceforge.net</a>. Other options can be found
2178
from the on-line documentation at
2179
<a href="http://bashdb.sourceforge.net/bashdb.html">http://bashdb.sourceforge.net/bashdb.html</a>
2180
2181
<div class="node">
2182
<p><hr>
2183
<a name="GNU-Make-Options"></a>
2184
Next: <a rel="next" accesskey="n" href="#Perl-Options">Perl Options</a>,
2185
Previous: <a rel="previous" accesskey="p" href="#Bash-Options">Bash Options</a>,
2186
Up: <a rel="up" accesskey="u" href="#Inferior-Debugger-Options">Inferior Debugger Options</a>
2187
</small>
2188
2189
2190
</div>
2191
2192
<h5 class="subsubsection">2.1.4.6 GNU Make Options</h5>
2193
2194
<p>If you have the proper <code>make</code> installed (for now it is probably
2195
called <code>remake</code>), the option needed to specify debugging support
2196
is <samp><span class="option">--debugger</span></samp>. You can pick up a debugger-enabled version
2197
from <a href="http://bashdb.sourceforge.net/remake">http://bashdb.sourceforge.net/remake</a>. Other options can be
2198
found from the on-line documentation at
2199
<a href="http://bashdb.sourceforge.net/remake/mdb.html">http://bashdb.sourceforge.net/remake/mdb.html</a>
2200
2201
<div class="node">
2202
<p><hr>
2203
<a name="Perl-Options"></a>
2204
Next: <a rel="next" accesskey="n" href="#PYDB-Options">PYDB Options</a>,
2205
Previous: <a rel="previous" accesskey="p" href="#GNU-Make-Options">GNU Make Options</a>,
2206
Up: <a rel="up" accesskey="u" href="#Inferior-Debugger-Options">Inferior Debugger Options</a>
2207
</small>
2208
2209
2210
</div>
2211
2212
<h5 class="subsubsection">2.1.4.7 Perl Options</h5>
2213
2214
<p>The most important Perl option to use with <acronym>DDD</acronym> is <samp><span class="option">-w</span></samp>; it
2315
2215
enables several important warnings. For further options, see the
2316
2216
<cite>perlrun(1)</cite> manual page.
2317
2217
2318
2218
<div class="node">
2319
2219
<p><hr>
2320
<small class=header>
2321
Node:<a name="Bash%20Options">Bash Options</a>,
2322
Previous:<a rel="previous" accesskey="p" href="#Perl%20Options">Perl Options</a>,
2323
Up:<a rel="up" accesskey="u" href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>
2220
<a name="PYDB-Options"></a>
2221
Previous: <a rel="previous" accesskey="p" href="#Perl-Options">Perl Options</a>,
2222
Up: <a rel="up" accesskey="u" href="#Inferior-Debugger-Options">Inferior Debugger Options</a>
2324
2223
</small>
2325
2224
2326
<br>
2225
2327
2226
</div>
2328
2227
2329
<h5 class="subsubsection">Bash Options</h5>
2228
<h5 class="subsubsection">2.1.4.8 PYDB Options</h5>
2330
2229
2331
<p>If you have the proper bash installed, the option needed to specify
2332
debugging support is <code>--debugger</code>. (If your bash doesn't
2333
understand this option you need to pick up a version of bash that does
2334
from <a href="http://bashdb.sourceforge.net">http://bashdb.sourceforge.net</a>.)
2230
<p>An older version of <code>pydb</code> used to come with <acronym>DDD</acronym>. That is no
2231
longer the case. Pick up the newer version of <code>pydb</code> from
2232
<a href="http://bashdb.sourceforge.net/pydb">http://bashdb.sourceforge.net/pydb</a>. For a list of useful
2233
<code>pydb</code> options, check out the <code>pydb</code> documentation,
2234
<a href="http://bashdb.sourceforge.net/pydb/pydb/lib/index.html">http://bashdb.sourceforge.net/pydb/pydb/lib/index.html</a>.
2335
2235
2336
2236
<div class="node">
2337
2237
<p><hr>
2338
<small class=header>
2339
Node:<a name="Multiple%20Instances">Multiple Instances</a>,
2340
Next:<a rel="next" accesskey="n" href="#X%20Warnings">X Warnings</a>,
2341
Previous:<a rel="previous" accesskey="p" href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>,
2342
Up:<a rel="up" accesskey="u" href="#Invoking">Invoking</a>
2238
<a name="Multiple-Instances"></a>
2239
Next: <a rel="next" accesskey="n" href="#X-Warnings">X Warnings</a>,
2240
Previous: <a rel="previous" accesskey="p" href="#Inferior-Debugger-Options">Inferior Debugger Options</a>,
2241
Up: <a rel="up" accesskey="u" href="#Invoking">Invoking</a>
2343
2242
</small>
2344
2243
2345
<br>
2244
2346
2245
</div>
2347
2246
2348
<h4 class="subsection">Multiple DDD Instances</h4>
2247
<h4 class="subsection">2.1.5 Multiple DDD Instances</h4>
2349
2248
2350
<p>If you have multiple <small>DDD</small> instances running, they share common
2249
<p>If you have multiple <acronym>DDD</acronym> instances running, they share common
2351
2250
preferences and history files. This means that changes applied to one
2352
2251
instance may get lost when being overwritten by the other instance.
2353
<small>DDD</small> has two means to protect you against unwanted losses. The
2252
<acronym>DDD</acronym> has two means to protect you against unwanted losses. The
2354
2253
first means is an automatic reloading of changed options, controlled by
2355
2254
the following resource (see <a href="#Customizing">Customizing</a>):
2356
2255
2357
<p>
2358
<table width="100%">
2359
<tr>
2360
<td align="left"><b>checkOptions</b><i> </i>(<i>class CheckOptions</i>)<i>
2361
</i></td>
2362
<td align="right">Resource</td>
2363
</tr>
2364
</table>
2365
<table width="95%" align="center">
2366
<tr><td>
2367
Every <var>n</var> seconds, where <var>n</var> is the value of this resource,
2368
<small>DDD</small> checks whether the options file has changed. Default is
2369
<code>30</code>, which means that every 30 seconds, <small>DDD</small> checks for the
2256
<div class="defun">
2257
— Resource: <b>checkOptions</b> (<var>class CheckOptions</var>)<var><a name="index-checkOptions-88"></a></var><br>
2258
<blockquote><p>Every <var>n</var> seconds, where <var>n</var> is the value of this resource,
2259
<acronym>DDD</acronym> checks whether the options file has changed. Default is
2260
<code>30</code>, which means that every 30 seconds, <acronym>DDD</acronym> checks for the
2370
2261
options file. Setting this resource to <code>0</code> disables checking for
2371
2262
changed option files.
2372
</td></tr>
2373
</table>
2263
</p></blockquote></div>
2374
2264
2375
<p>Normally, automatic reloading of options should already suffice. If you
2376
need stronger protection, <small>DDD</small> also provides a warning against
2265
<p><a name="index-Warn-if-Multiple-_0040value_007bDDD_007d-Instances-are-Running-89"></a>
2266
Normally, automatic reloading of options should already suffice. If you
2267
need stronger protection, <acronym>DDD</acronym> also provides a warning against
2377
2268
multiple instances. This warning is disabled by default, If you want to
2378
be warned about multiple <small>DDD</small> invocations sharing the same
2379
preferences and history files, enable <code>Edit => Preferences
2380
=> Warn if Multiple </code><small>DDD</small><code> Instances are Running</code>.
2269
be warned about multiple <acronym>DDD</acronym> invocations sharing the same
2270
preferences and history files, enable ‘<samp><span class="samp">Edit Preferences
2271
Warn if Multiple <acronym>DDD</acronym> Instances are Running</span></samp>’.
2381
2272
2382
2273
<p>This setting is tied to the following resource (see <a href="#Customizing">Customizing</a>):
2383
2274
2384
<p>
2385
<table width="100%">
2386
<tr>
2387
<td align="left"><b>warnIfLocked</b><i> </i>(<i>class WarnIfLocked</i>)<i>
2388
</i></td>
2389
<td align="right">Resource</td>
2390
</tr>
2391
</table>
2392
<table width="95%" align="center">
2393
<tr><td>
2394
Whether to warn if multiple <small>DDD</small> instances are running
2395
(<code>on</code>) or not (<code>off</code>, default).
2396
</td></tr>
2397
</table>
2275
<div class="defun">
2276
— Resource: <b>warnIfLocked</b> (<var>class WarnIfLocked</var>)<var><a name="index-warnIfLocked-90"></a></var><br>
2277
<blockquote><p>Whether to warn if multiple <acronym>DDD</acronym> instances are running
2278
(‘<samp><span class="samp">on</span></samp>’) or not (‘<samp><span class="samp">off</span></samp>’, default).
2279
</p></blockquote></div>
2398
2280
2399
2281
<div class="node">
2400
2282
<p><hr>
2401
<small class=header>
2402
Node:<a name="X%20Warnings">X Warnings</a>,
2403
Previous:<a rel="previous" accesskey="p" href="#Multiple%20Instances">Multiple Instances</a>,
2404
Up:<a rel="up" accesskey="u" href="#Invoking">Invoking</a>
2283
<a name="X-Warnings"></a>
2284
Previous: <a rel="previous" accesskey="p" href="#Multiple-Instances">Multiple Instances</a>,
2285
Up: <a rel="up" accesskey="u" href="#Invoking">Invoking</a>
2405
2286
</small>
2406
2287
2407
<br>
2288
2408
2289
</div>
2409
2290
2410
<h4 class="subsection">X warnings</h4>
2291
<h4 class="subsection">2.1.6 X warnings</h4>
2411
2292
2412
<p>If you are bothered by X warnings, you can suppress them by setting
2413
<code>Edit => Preferences => General => Suppress X
2414
warnings</code>.
2293
<p><a name="index-X-Warnings_002c-suppressing-91"></a><a name="index-Suppress-X-warnings-92"></a>If you are bothered by X warnings, you can suppress them by setting
2294
‘<samp><span class="samp">Edit Preferences General Suppress X
2295
warnings</span></samp>’.
2415
2296
2416
2297
<p>This setting is tied to the following resource (see <a href="#Customizing">Customizing</a>):
2417
2298
2418
<p>
2419
<table width="100%">
2420
<tr>
2421
<td align="left"><b>suppressWarnings</b><i> </i>(<i>class SuppressWarnings</i>)<i>
2422
</i></td>
2423
<td align="right">Resource</td>
2424
</tr>
2425
</table>
2426
<table width="95%" align="center">
2427
<tr><td>
2428
If <code>on</code>, X warnings are suppressed. This is
2299
<div class="defun">
2300
— Resource: <b>suppressWarnings</b> (<var>class SuppressWarnings</var>)<var><a name="index-suppressWarnings-93"></a></var><br>
2301
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, X warnings are suppressed. This is
2429
2302
sometimes useful for executables that were built on a machine with a
2430
2303
different X or M*tif configuration. By default, this is
2431
<code>off</code>.
2432
</td></tr>
2433
</table>
2304
‘<samp><span class="samp">off</span></samp>’.
2305
</p></blockquote></div>
2434
2306
2435
2307
<div class="node">
2436
2308
<p><hr>
2437
<small class=header>
2438
Node:<a name="Quitting">Quitting</a>,
2439
Next:<a rel="next" accesskey="n" href="#Sessions">Sessions</a>,
2440
Previous:<a rel="previous" accesskey="p" href="#Invoking">Invoking</a>,
2441
Up:<a rel="up" accesskey="u" href="#Invocation">Invocation</a>
2309
<a name="Quitting"></a>
2310
Next: <a rel="next" accesskey="n" href="#Sessions">Sessions</a>,
2311
Previous: <a rel="previous" accesskey="p" href="#Invoking">Invoking</a>,
2312
Up: <a rel="up" accesskey="u" href="#Invocation">Invocation</a>
2442
2313
</small>
2443
2314
2444
<br>
2315
2445
2316
</div>
2446
2317
2447
<h3 class="section">Quitting DDD</h3>
2318
<h3 class="section">2.2 Quitting DDD</h3>
2448
2319
2449
<p>To exit <small>DDD</small>, select <code>File => Exit</code>. You may also
2450
type the <code>quit</code> command at the debugger prompt or press
2451
<Ctrl+Q>. <small>GDB</small> and <small>XDB</small> also accept the <code>q</code> command or an
2320
<p><a name="index-Ctrl_002bD-94"></a><a name="index-Ctrl_002bQ-95"></a><a name="index-Exit-96"></a><a name="index-Exiting-97"></a><a name="index-Quitting-98"></a><a name="index-quit-99"></a>To exit <acronym>DDD</acronym>, select ‘<samp><span class="samp">File Exit</span></samp>’. You may also
2321
type the <samp><span class="command">quit</span></samp> command at the debugger prompt or press
2322
<Ctrl+Q>. <acronym>GDB</acronym> and <acronym>XDB</acronym> also accept the <samp><span class="command">q</span></samp> command or an
2452
2323
end-of-file character (usually <Ctrl+D>). Closing the last
2453
<small>DDD</small> window will also exit <small>DDD</small>.
2324
<acronym>DDD</acronym> window will also exit <acronym>DDD</acronym>.
2454
2325
2455
<p>An interrupt (<ESC> or <code>Interrupt</code>) does not exit from
2456
<small>DDD</small>, but rather terminates the action of any debugger command
2326
<p><a name="index-ESC-100"></a><a name="index-Interrupting-execution-101"></a><a name="index-Execution_002c-interrupting-102"></a>An interrupt (<ESC> or ‘<samp><span class="samp">Interrupt</span></samp>’) does not exit from
2327
<acronym>DDD</acronym>, but rather terminates the action of any debugger command
2457
2328
that is in progress and returns to the debugger command level. It is
2458
2329
safe to type the interrupt character at any time because the debugger
2459
2330
does not allow it to take effect until a time when it is safe.
2460
2331
2461
<p>In case an ordinary interrupt does not succeed, you can also use an
2462
abort (<Ctrl+\> or <code>Abort</code>), which sends a <code>SIGABRT</code>
2332
<p><a name="index-Ctrl_002b_005c-103"></a><a name="index-Abort-104"></a><a name="index-Aborting-execution-105"></a><a name="index-Execution_002c-aborting-106"></a><a name="index-SIGABRT-signal-107"></a>In case an ordinary interrupt does not succeed, you can also use an
2333
abort (<Ctrl+\> or ‘<samp><span class="samp">Abort</span></samp>’), which sends a <code>SIGABRT</code>
2463
2334
signal to the inferior debugger. Use this in emergencies only; the
2464
2335
inferior debugger may be left inconsistent or even exit after a
2465
2336
<code>SIGABRT</code> signal.
2466
2337
2467
<p>As a last resort (if <small>DDD</small> hangs, for example), you may also
2468
interrupt <small>DDD</small> itself using an interrupt signal (<code>SIGINT</code>).
2338
<p><a name="index-Ctrl_002bC-108"></a><a name="index-Interrupting-_0040DDD_007b_007d-109"></a><a name="index-Signal_002c-sending-to-_0040DDD_007b_007d-110"></a><a name="index-Killing-_0040DDD_007b_007d-111"></a>As a last resort (if <acronym>DDD</acronym> hangs, for example), you may also
2339
interrupt <acronym>DDD</acronym> itself using an interrupt signal (<code>SIGINT</code>).
2469
2340
This can be done by typing the interrupt character (usually
2470
<Ctrl+C>) in the shell <small>DDD</small> was started from, or by using the
2471
<small>UNIX</small> <code>kill</code> command. An interrupt signal interrupts any
2472
<small>DDD</small> action; the inferior debugger is interrupted as well. Since
2341
<Ctrl+C>) in the shell <acronym>DDD</acronym> was started from, or by using the
2342
<acronym>UNIX</acronym> ‘<samp><span class="samp">kill</span></samp>’ command. An interrupt signal interrupts any
2343
<acronym>DDD</acronym> action; the inferior debugger is interrupted as well. Since
2473
2344
this interrupt signal can result in internal inconsistencies, use this
2474
2345
as a last resort in emergencies only; save your work as soon as possible
2475
and restart <small>DDD</small>.
2346
and restart <acronym>DDD</acronym>.
2476
2347
2477
2348
<div class="node">
2478
2349
<p><hr>
2479
<small class=header>
2480
Node:<a name="Sessions">Sessions</a>,
2481
Next:<a rel="next" accesskey="n" href="#Remote%20Debugging">Remote Debugging</a>,
2482
Previous:<a rel="previous" accesskey="p" href="#Quitting">Quitting</a>,
2483
Up:<a rel="up" accesskey="u" href="#Invocation">Invocation</a>
2350
<a name="Sessions"></a>
2351
Next: <a rel="next" accesskey="n" href="#Remote-Debugging">Remote Debugging</a>,
2352
Previous: <a rel="previous" accesskey="p" href="#Quitting">Quitting</a>,
2353
Up: <a rel="up" accesskey="u" href="#Invocation">Invocation</a>
2484
2354
</small>
2485
2355
2486
<br>
2356
2487
2357
</div>
2488
2358
2489
<h3 class="section">Persistent Sessions</h3>
2359
<h3 class="section">2.3 Persistent Sessions</h3>
2490
2360
2491
<p>If you want to interrupt your current <small>DDD</small> session, you can save
2492
the entire the entire <small>DDD</small> state as <dfn>session</dfn> on disk and
2361
<p><a name="index-Session-112"></a>
2362
If you want to interrupt your current <acronym>DDD</acronym> session, you can save
2363
the entire the entire <acronym>DDD</acronym> state as <dfn>session</dfn> on disk and
2493
2364
resume later.
2494
2365
2495
2366
<ul class="menu">
2496
<li><a accesskey="1" href="#Saving%20Sessions">Saving Sessions</a>:
2497
<li><a accesskey="2" href="#Resuming%20Sessions">Resuming Sessions</a>:
2498
<li><a accesskey="3" href="#Deleting%20Sessions">Deleting Sessions</a>:
2499
<li><a accesskey="4" href="#Customizing%20Sessions">Customizing Sessions</a>:
2367
<li><a accesskey="1" href="#Saving-Sessions">Saving Sessions</a>
2368
<li><a accesskey="2" href="#Resuming-Sessions">Resuming Sessions</a>
2369
<li><a accesskey="3" href="#Deleting-Sessions">Deleting Sessions</a>
2370
<li><a accesskey="4" href="#Customizing-Sessions">Customizing Sessions</a>
2500
2371
</ul>
2501
2372
2502
2373
<div class="node">
2503
2374
<p><hr>
2504
<small class=header>
2505
Node:<a name="Saving%20Sessions">Saving Sessions</a>,
2506
Next:<a rel="next" accesskey="n" href="#Resuming%20Sessions">Resuming Sessions</a>,
2507
Up:<a rel="up" accesskey="u" href="#Sessions">Sessions</a>
2375
<a name="Saving-Sessions"></a>
2376
Next: <a rel="next" accesskey="n" href="#Resuming-Sessions">Resuming Sessions</a>,
2377
Up: <a rel="up" accesskey="u" href="#Sessions">Sessions</a>
2508
2378
</small>
2509
2379
2510
<br>
2380
2511
2381
</div>
2512
2382
2513
<h4 class="subsection">Saving Sessions</h4>
2383
<h4 class="subsection">2.3.1 Saving Sessions</h4>
2514
2384
2515
<p>To save a session, select <code>File => Save Session As</code>. You will
2385
<p><a name="index-Session_002c-saving-113"></a><a name="index-Save-Session-As-114"></a>To save a session, select ‘<samp><span class="samp">File Save Session As</span></samp>’. You will
2516
2386
be asked for a symbolic session name <var>session</var>.
2517
2387
2518
<p>If your program is running (see <a href="#Running">Running</a>), or if you have opened a
2519
core file (see <a href="#Opening%20Core%20Dumps">Opening Core Dumps</a>), <small>DDD</small> can also include a
2388
<p><a name="index-Core-file_002c-in-sessions-115"></a>If your program is running (see <a href="#Running">Running</a>), or if you have opened a
2389
core file (see <a href="#Opening-Core-Dumps">Opening Core Dumps</a>), <acronym>DDD</acronym> can also include a
2520
2390
core file in the session such that the debuggee data will be restored
2521
when re-opening it. To get a core file, <small>DDD</small> typically must
2391
when re-opening it. To get a core file, <acronym>DDD</acronym> typically must
2522
2392
<dfn>kill</dfn> the debuggee. This means that you cannot resume program
2523
2393
execution after saving a session. Depending on your architecture, other
2524
2394
options for getting a core file may also be available.
2525
2395
2526
<p>Including a core dump is necessary for restoring memory contents and the
2396
<p><a name="index-Include-Core-Dump-116"></a>Including a core dump is necessary for restoring memory contents and the
2527
2397
current execution position. To include a core dump, enable
2528
<code>Include Core Dump</code>.
2529
2530
<br><p>
2398
‘<samp><span class="samp">Include Core Dump</span></samp>’.
2399
2400
<pre class="sp">
2401
2402
</pre>
2531
2403
<div align="center"><img src="PICS/ddd-save-session.jpg" alt="PICS/ddd-save-session.jpg"></div>
2532
<br><p>
2533
<p>After clicking on <code>Save</code>, the session is saved in
2534
<code>~/.ddd/sessions/</code><var>session</var><code></code>.
2404
<pre class="sp">
2405
2406
</pre>
2407
2408
After clicking on ‘<samp><span class="samp">Save</span></samp>’, the session is saved in
2409
<samp><span class="file">~/.ddd/sessions/</span><var>session</var></samp>.
2535
2410
2536
2411
<p>Here's a list of the items whose state is saved in a session:
2537
2412
<ul>
2538
<li>The state of the debugged program, as a core file.<a rel="footnote" href="#fn-5"><sup>5</sup></a>
2413
<li>The state of the debugged program, as a core file.<a rel="footnote" href="#fn-5" name="fnd-5"><sup>5</sup></a>
2539
2414
2540
2415
<li>All breakpoints and watchpoints (see <a href="#Stopping">Stopping</a>).
2541
2416
2542
2417
<li>All signal settings (see <a href="#Signals">Signals</a>).
2543
2418
2544
<li>All displays (see <a href="#Displaying%20Values">Displaying Values</a>).<a rel="footnote" href="#fn-6"><sup>6</sup></a>
2545
2546
<li>All <small>DDD</small> options (see <a href="#Saving%20Options">Saving Options</a>).
2547
2548
<li>All debugger settings (see <a href="#Debugger%20Settings">Debugger Settings</a>).
2549
2550
<li>All user-defined buttons (see <a href="#Defining%20Buttons">Defining Buttons</a>).
2551
2552
<li>All user-defined commands (see <a href="#Defining%20Commands">Defining Commands</a>).
2553
2554
<li>The positions and sizes of <small>DDD</small> windows.
2555
2556
<li>The command history (see <a href="#Command%20History">Command History</a>).
2419
<li><a name="index-Deferred-display_002c-in-sessions-117"></a>All displays (see <a href="#Displaying-Values">Displaying Values</a>).<a rel="footnote" href="#fn-6" name="fnd-6"><sup>6</sup></a>
2420
2421
<li>All <acronym>DDD</acronym> options (see <a href="#Saving-Options">Saving Options</a>).
2422
2423
<li>All debugger settings (see <a href="#Debugger-Settings">Debugger Settings</a>).
2424
2425
<li>All user-defined buttons (see <a href="#Defining-Buttons">Defining Buttons</a>).
2426
2427
<li>All user-defined commands (see <a href="#Defining-Commands">Defining Commands</a>).
2428
2429
<li>The positions and sizes of <acronym>DDD</acronym> windows.
2430
2431
<li>The command history (see <a href="#Command-History">Command History</a>).
2557
2432
</ul>
2558
2433
2559
<p>After saving the current state as a session, the session becomes
2560
<dfn>active</dfn>. This means that <small>DDD</small> state will be saved as
2434
<p><a name="index-Session_002c-active-118"></a>After saving the current state as a session, the session becomes
2435
<dfn>active</dfn>. This means that <acronym>DDD</acronym> state will be saved as
2561
2436
session defaults:
2562
2437
2563
2438
<ul>
2564
2439
<li>User options will be saved in
2565
<code>~/.ddd/sessions/</code><var>session</var><code>/init</code> instead of
2566
<code>~/.ddd/init</code>. See <a href="#Saving%20Options">Saving Options</a>, for details.
2440
<samp><span class="file">~/.ddd/sessions/</span><var>session</var><span class="file">/init</span></samp> instead of
2441
<samp><span class="file">~/.ddd/init</span></samp>. See <a href="#Saving-Options">Saving Options</a>, for details.
2567
2442
2568
<li>The <small>DDD</small> command history will be saved in
2569
<code>~/.ddd/sessions/</code><var>session</var><code>/history</code> instead of
2570
<code>~/.ddd/history</code>. See <a href="#Command%20History">Command History</a>, for details.
2443
<li>The <acronym>DDD</acronym> command history will be saved in
2444
<samp><span class="file">~/.ddd/sessions/</span><var>session</var><span class="file">/history</span></samp> instead of
2445
<samp><span class="file">~/.ddd/history</span></samp>. See <a href="#Command-History">Command History</a>, for details.
2571
2446
</ul>
2572
2447
2573
2448
<p>To make the current session inactive, open the <em>default session</em>
2574
named <code>[None]</code>. See <a href="#Resuming%20Sessions">Resuming Sessions</a>, for details on opening
2449
named ‘<samp><span class="samp">[None]</span></samp>’. See <a href="#Resuming-Sessions">Resuming Sessions</a>, for details on opening
2575
2450
sessions.
2576
2451
2577
2452
<div class="node">
2578
2453
<p><hr>
2579
<small class=header>
2580
Node:<a name="Resuming%20Sessions">Resuming Sessions</a>,
2581
Next:<a rel="next" accesskey="n" href="#Deleting%20Sessions">Deleting Sessions</a>,
2582
Previous:<a rel="previous" accesskey="p" href="#Saving%20Sessions">Saving Sessions</a>,
2583
Up:<a rel="up" accesskey="u" href="#Sessions">Sessions</a>
2454
<a name="Resuming-Sessions"></a>
2455
Next: <a rel="next" accesskey="n" href="#Deleting-Sessions">Deleting Sessions</a>,
2456
Previous: <a rel="previous" accesskey="p" href="#Saving-Sessions">Saving Sessions</a>,
2457
Up: <a rel="up" accesskey="u" href="#Sessions">Sessions</a>
2584
2458
</small>
2585
2459
2586
<br>
2460
2587
2461
</div>
2588
2462
2589
<h4 class="subsection">Resuming Sessions</h4>
2463
<h4 class="subsection">2.3.2 Resuming Sessions</h4>
2590
2464
2591
<p>To resume a previously saved session, select <code>File => Open
2592
Session</code> and choose a session name from the list. After clicking on
2593
<code>Open</code>, the entire <small>DDD</small> state will be restored from the
2465
<p><a name="index-Session_002c-opening-119"></a><a name="index-Session_002c-resuming-120"></a>
2466
<a name="index-Open-Session-121"></a>To resume a previously saved session, select ‘<samp><span class="samp">File Open
2467
Session</span></samp>’ and choose a session name from the list. After clicking on
2468
‘<samp><span class="samp">Open</span></samp>’, the entire <acronym>DDD</acronym> state will be restored from the
2594
2469
given session.
2595
2470
2596
<p>The session named <code>[None]</code> is the <dfn>default session</dfn> which is
2597
active when starting <small>DDD</small>. To save options for default sessions,
2598
choose the default session before exiting <small>DDD</small>. See <a href="#Saving%20Options">Saving Options</a>, for details.
2599
2600
<br><p>
2471
<p><a name="index-Default-session-122"></a><a name="index-Session_002c-default-123"></a>The session named ‘<samp><span class="samp">[None]</span></samp>’ is the <dfn>default session</dfn> which is
2472
active when starting <acronym>DDD</acronym>. To save options for default sessions,
2473
choose the default session before exiting <acronym>DDD</acronym>. See <a href="#Saving-Options">Saving Options</a>, for details.
2474
2475
<pre class="sp">
2476
2477
</pre>
2601
2478
<div align="center"><img src="PICS/ddd-open-session.jpg" alt="PICS/ddd-open-session.jpg"></div>
2602
<br><p>
2603
<p>If a the restored session includes a core dump, the program being
2479
<pre class="sp">
2480
2481
</pre>
2482
2483
If a the restored session includes a core dump, the program being
2604
2484
debugged will be in the same state at the time the session was saved; in
2605
2485
particular, you can examine the program data. However, you will not be
2606
2486
able to resume program execution since the process and its environment
2611
2491
shortcuts and the source tab width. This way, you can maintain a
2612
2492
different set of definitions for each session.
2613
2493
2614
<p>You can also specify a session to open when starting <small>DDD</small>. To
2615
invoke <small>DDD</small> with a session <var>session</var>, use
2494
<p>You can also specify a session to open when starting <acronym>DDD</acronym>. To
2495
invoke <acronym>DDD</acronym> with a session <var>session</var>, use
2616
2496
2617
2497
<pre class="example"> ddd --session <var>session</var>
2618
</pre>
2619
2498
</pre>
2620
2499
<p>There is also a shortcut that opens the session <var>session</var> and
2621
2500
invokes the inferior debugger on an executable named <var>session</var> (in
2622
2501
case <var>session</var> cannot be opened):
2623
2502
2624
2503
<pre class="example"> ddd =<var>session</var>
2625
</pre>
2626
2504
</pre>
2627
2505
<p>There is no need to give further command-line options when restarting a
2628
2506
session, as they will be overridden by the options saved in the session.
2629
2507
2630
<p>You can also use an X session manager such as <code>xsm</code> to save and
2631
restore <small>DDD</small> sessions.<a rel="footnote" href="#fn-7"><sup>7</sup></a> When
2632
being shut down by a session manager, <small>DDD</small> saves its state under
2508
<p><a name="index-xsm-124"></a><a name="index-X-session-125"></a>You can also use an X session manager such as <samp><span class="command">xsm</span></samp> to save and
2509
restore <acronym>DDD</acronym> sessions.<a rel="footnote" href="#fn-7" name="fnd-7"><sup>7</sup></a> When
2510
being shut down by a session manager, <acronym>DDD</acronym> saves its state under
2633
2511
the name specified by the session manager; resuming the X session makes
2634
<small>DDD</small> reload its saved state.
2635
2636
<div class="node">
2637
<p><hr>
2638
<small class=header>
2639
Node:<a name="Deleting%20Sessions">Deleting Sessions</a>,
2640
Next:<a rel="next" accesskey="n" href="#Customizing%20Sessions">Customizing Sessions</a>,
2641
Previous:<a rel="previous" accesskey="p" href="#Resuming%20Sessions">Resuming Sessions</a>,
2642
Up:<a rel="up" accesskey="u" href="#Sessions">Sessions</a>
2643
</small>
2644
2645
<br>
2646
</div>
2647
2648
<h4 class="subsection">Deleting Sessions</h4>
2649
2650
<p>To delete sessions that are no longer needed, select <code>File
2651
=> Open Session</code> or <code>File => Save Session</code>. Select
2652
the sessions you want to delete and click on <code>Delete</code>.
2653
2654
<p>The default session <code>[None]</code> cannot be deleted.
2655
2656
<div class="node">
2657
<p><hr>
2658
<small class=header>
2659
Node:<a name="Customizing%20Sessions">Customizing Sessions</a>,
2660
Previous:<a rel="previous" accesskey="p" href="#Deleting%20Sessions">Deleting Sessions</a>,
2661
Up:<a rel="up" accesskey="u" href="#Sessions">Sessions</a>
2662
</small>
2663
2664
<br>
2665
</div>
2666
2667
<h4 class="subsection">Customizing Sessions</h4>
2668
2669
<p>You can change the place where <small>DDD</small> saves its sessions by setting
2670
the environment variable <code>DDD_SESSIONS</code> to the name of a directory.
2671
Default is <code>~/.ddd/sessions/</code>.
2672
2673
<p>Where applicable, <small>DDD</small> supports a <code>gcore</code> command to obtain
2512
<acronym>DDD</acronym> reload its saved state.
2513
2514
<div class="node">
2515
<p><hr>
2516
<a name="Deleting-Sessions"></a>
2517
Next: <a rel="next" accesskey="n" href="#Customizing-Sessions">Customizing Sessions</a>,
2518
Previous: <a rel="previous" accesskey="p" href="#Resuming-Sessions">Resuming Sessions</a>,
2519
Up: <a rel="up" accesskey="u" href="#Sessions">Sessions</a>
2520
</small>
2521
2522
2523
</div>
2524
2525
<h4 class="subsection">2.3.3 Deleting Sessions</h4>
2526
2527
<p><a name="index-Session_002c-deleting-126"></a>
2528
<a name="index-Delete-127"></a>To delete sessions that are no longer needed, select ‘<samp><span class="samp">File
2529
Open Session</span></samp>’ or ‘<samp><span class="samp">File Save Session</span></samp>’. Select
2530
the sessions you want to delete and click on ‘<samp><span class="samp">Delete</span></samp>’.
2531
2532
<p>The default session ‘<samp><span class="samp">[None]</span></samp>’ cannot be deleted.
2533
2534
<div class="node">
2535
<p><hr>
2536
<a name="Customizing-Sessions"></a>
2537
Previous: <a rel="previous" accesskey="p" href="#Deleting-Sessions">Deleting Sessions</a>,
2538
Up: <a rel="up" accesskey="u" href="#Sessions">Sessions</a>
2539
</small>
2540
2541
2542
</div>
2543
2544
<h4 class="subsection">2.3.4 Customizing Sessions</h4>
2545
2546
<p><a name="index-DDD_005fSESSIONS-128"></a><a name="index-sessions-129"></a>You can change the place where <acronym>DDD</acronym> saves its sessions by setting
2547
the environment variable <samp><span class="env">DDD_SESSIONS</span></samp> to the name of a directory.
2548
Default is <samp><span class="file">~/.ddd/sessions/</span></samp>.
2549
2550
<p><a name="index-Get-Core-File-130"></a><a name="index-gcore-131"></a>Where applicable, <acronym>DDD</acronym> supports a <samp><span class="command">gcore</span></samp> command to obtain
2674
2551
core files of the running program. You can enter its path via
2675
<code>Edit => Preferences => Helpers => Get Core
2676
File</code>. Leave the value empty if you have no <code>gcore</code> or similar
2552
‘<samp><span class="samp">Edit Preferences Helpers Get Core
2553
File</span></samp>’. Leave the value empty if you have no <samp><span class="command">gcore</span></samp> or similar
2677
2554
command.
2678
2555
2679
2556
<p>This setting is tied to the following resource (see <a href="#Customizing">Customizing</a>):
2680
2557
2681
<p>
2682
<table width="100%">
2683
<tr>
2684
<td align="left"><b>getCoreCommand</b><i> </i>(<i>class GetCoreCommand</i>)<i>
2685
</i></td>
2686
<td align="right">Resource</td>
2687
</tr>
2688
</table>
2689
<table width="95%" align="center">
2690
<tr><td>
2691
A command to get a core dump of a running process (typically,
2692
<code>gcore</code>) <code>@FILE@</code> is replaced by the base name of the file
2693
to create; <code>@PID@</code> is replaced by the process id. The output
2694
must be written to <code>@FILE@.@PID@</code>.
2558
<div class="defun">
2559
— Resource: <b>getCoreCommand</b> (<var>class GetCoreCommand</var>)<var><a name="index-getCoreCommand-132"></a></var><br>
2560
<blockquote><p>A command to get a core dump of a running process (typically,
2561
<samp><span class="command">gcore</span></samp>) ‘<samp><span class="samp">@FILE@</span></samp>’ is replaced by the base name of the file
2562
to create; ‘<samp><span class="samp">@PID@</span></samp>’ is replaced by the process id. The output
2563
must be written to ‘<samp><span class="samp">@FILE@.@PID@</span></samp>’.
2695
2564
2696
<p>Leave the value empty if you have no <code>gcore</code> or similar command.
2697
</td></tr>
2698
</table>
2565
<p>Leave the value empty if you have no <samp><span class="command">gcore</span></samp> or similar command.
2566
</p></blockquote></div>
2699
2567
2700
2568
<div class="node">
2701
2569
<p><hr>
2702
<small class=header>
2703
Node:<a name="Remote%20Debugging">Remote Debugging</a>,
2704
Next:<a rel="next" accesskey="n" href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>,
2705
Previous:<a rel="previous" accesskey="p" href="#Sessions">Sessions</a>,
2706
Up:<a rel="up" accesskey="u" href="#Invocation">Invocation</a>
2570
<a name="Remote-Debugging"></a>
2571
Next: <a rel="next" accesskey="n" href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>,
2572
Previous: <a rel="previous" accesskey="p" href="#Sessions">Sessions</a>,
2573
Up: <a rel="up" accesskey="u" href="#Invocation">Invocation</a>
2707
2574
</small>
2708
2575
2709
<br>
2576
2710
2577
</div>
2711
2578
2712
<h3 class="section">Remote Debugging</h3>
2579
<h3 class="section">2.4 Remote Debugging</h3>
2713
2580
2714
<p>You can have each of <small>DDD</small>, the inferior debugger, and the
2581
<p>You can have each of <acronym>DDD</acronym>, the inferior debugger, and the
2715
2582
debugged program run on different machines.
2716
2583
2717
2584
<ul class="menu">
2718
<li><a accesskey="1" href="#Remote%20Host">Remote Host</a>: Running <small>DDD</small> on a Remote Host
2719
<li><a accesskey="2" href="#Remote%20Debugger">Remote Debugger</a>: Using a Remote Inferior Debugger
2720
<li><a accesskey="3" href="#Remote%20Program">Remote Program</a>: Debugging a Remote Program
2585
<li><a accesskey="1" href="#Remote-Host">Remote Host</a>: Running <acronym>DDD</acronym> on a Remote Host
2586
<li><a accesskey="2" href="#Remote-Debugger">Remote Debugger</a>: Using a Remote Inferior Debugger
2587
<li><a accesskey="3" href="#Remote-Program">Remote Program</a>: Debugging a Remote Program
2721
2588
</ul>
2722
2589
2723
2590
<div class="node">
2724
2591
<p><hr>
2725
<small class=header>
2726
Node:<a name="Remote%20Host">Remote Host</a>,
2727
Next:<a rel="next" accesskey="n" href="#Remote%20Debugger">Remote Debugger</a>,
2728
Up:<a rel="up" accesskey="u" href="#Remote%20Debugging">Remote Debugging</a>
2592
<a name="Remote-Host"></a>
2593
Next: <a rel="next" accesskey="n" href="#Remote-Debugger">Remote Debugger</a>,
2594
Up: <a rel="up" accesskey="u" href="#Remote-Debugging">Remote Debugging</a>
2729
2595
</small>
2730
2596
2731
<br>
2597
2732
2598
</div>
2733
2599
2734
<h4 class="subsection">Running DDD on a Remote Host</h4>
2600
<h4 class="subsection">2.4.1 Running DDD on a Remote Host</h4>
2735
2601
2736
<p>You can run <small>DDD</small> on a remote host, using your current host as X
2737
display. On the remote host, invoke <small>DDD</small> as
2602
<p><a name="index-Remote-host-133"></a><a name="index-Host_002c-remote-134"></a><a name="index-Display_002c-setting-135"></a>
2603
You can run <acronym>DDD</acronym> on a remote host, using your current host as X
2604
display. On the remote host, invoke <acronym>DDD</acronym> as
2738
2605
2739
2606
<pre class="example"> ddd -display <var>display</var>
2740
</pre>
2741
2742
<p>where <var>display</var> is the name of the X server to connect to (for
2743
instance, <code></code><var>hostname</var><code>:0.0</code>, where <var>hostname</var> is your host).
2744
2745
<p>Instead of specifying <code>-display </code><var>display</var><code></code>, you can also set
2746
the <code>DISPLAY</code> environment variable to <var>display</var>.
2607
</pre>
2608
<p class="noindent">where <var>display</var> is the name of the X server to connect to (for
2609
instance, ‘<samp><var>hostname</var><span class="samp">:0.0</span></samp>’, where <var>hostname</var> is your host).
2610
2611
<p><a name="index-DISPLAY-136"></a>Instead of specifying <samp><span class="option">-display </span><var>display</var></samp>, you can also set
2612
the <samp><span class="env">DISPLAY</span></samp> environment variable to <var>display</var>.
2747
2613
2748
2614
<div class="node">
2749
2615
<p><hr>
2750
<small class=header>
2751
Node:<a name="Remote%20Debugger">Remote Debugger</a>,
2752
Next:<a rel="next" accesskey="n" href="#Remote%20Program">Remote Program</a>,
2753
Previous:<a rel="previous" accesskey="p" href="#Remote%20Host">Remote Host</a>,
2754
Up:<a rel="up" accesskey="u" href="#Remote%20Debugging">Remote Debugging</a>
2616
<a name="Remote-Debugger"></a>
2617
Next: <a rel="next" accesskey="n" href="#Remote-Program">Remote Program</a>,
2618
Previous: <a rel="previous" accesskey="p" href="#Remote-Host">Remote Host</a>,
2619
Up: <a rel="up" accesskey="u" href="#Remote-Debugging">Remote Debugging</a>
2755
2620
</small>
2756
2621
2757
<br>
2622
2758
2623
</div>
2759
2624
2760
<h4 class="subsection">Using DDD with a Remote Inferior Debugger</h4>
2625
<h4 class="subsection">2.4.2 Using DDD with a Remote Inferior Debugger</h4>
2761
2626
2762
<p>In order to run the inferior debugger on a remote host, you need
2763
<code>remsh</code> (called <code>rsh</code> on BSD systems) access on the remote
2627
<p><a name="index-Remote-debugger-137"></a><a name="index-Debugger_002c-on-remote-host-138"></a>
2628
<a name="index-remsh-139"></a><a name="index-rsh-140"></a>In order to run the inferior debugger on a remote host, you need
2629
‘<samp><span class="samp">remsh</span></samp>’ (called ‘<samp><span class="samp">rsh</span></samp>’ on BSD systems) access on the remote
2764
2630
host.
2765
2631
2766
<p>To run the debugger on a remote host <var>hostname</var>, invoke <small>DDD</small> as
2632
<p>To run the debugger on a remote host <var>hostname</var>, invoke <acronym>DDD</acronym> as
2767
2633
<pre class="example"> ddd --host <var>hostname</var> <var>remote-program</var>
2768
</pre>
2769
2634
</pre>
2770
2635
<p>If your remote <var>username</var> differs from the local username, use
2771
2636
2772
2637
<pre class="example"> ddd --host <var>hostname</var> --login <var>username</var> <var>remote-program</var>
2773
</pre>
2774
2775
<p>or
2638
</pre>
2639
<p class="noindent">or
2776
2640
2777
2641
<pre class="example"> ddd --host <var>username</var>@<var>hostname</var> <var>remote-program</var>
2778
</pre>
2779
2780
<p>instead.
2642
</pre>
2643
<p class="noindent">instead.
2781
2644
2782
2645
<p>There are a few <em>caveats</em> in remote mode:
2783
2646
2788
2651
remote core files. Also, be sure to specify a remote process id when
2789
2652
debugging a running program.
2790
2653
2791
<li>The remote debugger is started non-interactively. Some <small>DBX</small> versions
2654
<li>The remote debugger is started non-interactively. Some <acronym>DBX</acronym> versions
2792
2655
have trouble with this. If you do not get a prompt from the remote
2793
debugger, use the <code>--rhost</code> option instead of <code>--host</code>. This
2656
debugger, use the <samp><span class="option">--rhost</span></samp> option instead of <samp><span class="option">--host</span></samp>. This
2794
2657
will invoke the remote debugger via an interactive shell on the remote
2795
2658
host, which may lead to better results.
2796
2659
2797
<p>Note: using <code>--rhost</code>, <small>DDD</small> invokes the inferior debugger as
2660
<p>Note: using <samp><span class="option">--rhost</span></samp>, <acronym>DDD</acronym> invokes the inferior debugger as
2798
2661
soon as a shell prompt appears. The first output on the remote host
2799
ending in a space character or <code>></code> and not followed by a newline is
2662
ending in a space character or ‘<samp><span class="samp">></span></samp>’ and not followed by a newline is
2800
2663
assumed to be a shell prompt. If necessary, adjust your shell prompt on
2801
2664
the remote host.
2802
2665
2803
</p><li>To run the remote program, <small>DDD</small> invokes an <code>xterm</code> terminal
2804
emulator on the remote host, giving your current <code>DISPLAY</code>
2666
<li>To run the remote program, <acronym>DDD</acronym> invokes an ‘<samp><span class="samp">xterm</span></samp>’ terminal
2667
emulator on the remote host, giving your current ‘<samp><span class="samp">DISPLAY</span></samp>’
2805
2668
environment variable as address. If the remote host cannot invoke
2806
<code>xterm</code>, or does not have access to your X display, start
2807
<small>DDD</small> with the <code>--no-exec-window</code> option. The program
2808
input/output will then go through the <small>DDD</small> debugger console.
2669
‘<samp><span class="samp">xterm</span></samp>’, or does not have access to your X display, start
2670
<acronym>DDD</acronym> with the <samp><span class="option">--no-exec-window</span></samp> option. The program
2671
input/output will then go through the <acronym>DDD</acronym> debugger console.
2809
2672
2810
2673
<li>In remote mode, all sources are loaded from the remote host; file
2811
2674
dialogs scan remote directories. This may result in somewhat slower
2812
2675
operation than normal.
2813
2676
2814
<li>To help you find problems due to remote execution, run <small>DDD</small> with
2815
the <code>--trace</code> option. This prints the shell commands issued by
2816
<small>DDD</small> on standard error.
2677
<li>To help you find problems due to remote execution, run <acronym>DDD</acronym> with
2678
the <samp><span class="option">--trace</span></samp> option. This prints the shell commands issued by
2679
<acronym>DDD</acronym> on standard error.
2817
2680
</ul>
2818
2681
2819
<p>See <a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>, for customizing remote mode.
2682
<p>See <a href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a>, for customizing remote mode.
2820
2683
2821
2684
<ul class="menu">
2822
<li><a accesskey="1" href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>:
2685
<li><a accesskey="1" href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a>
2823
2686
</ul>
2824
2687
2825
2688
<div class="node">
2826
2689
<p><hr>
2827
<small class=header>
2828
Node:<a name="Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>,
2829
Up:<a rel="up" accesskey="u" href="#Remote%20Debugger">Remote Debugger</a>
2690
<a name="Customizing-Remote-Debugging"></a>
2691
Up: <a rel="up" accesskey="u" href="#Remote-Debugger">Remote Debugger</a>
2830
2692
</small>
2831
2693
2832
<br>
2694
2833
2695
</div>
2834
2696
2835
<h5 class="subsubsection">Customizing Remote Debugging</h5>
2697
<h5 class="subsubsection">2.4.2.1 Customizing Remote Debugging</h5>
2836
2698
2837
<p>When having the inferior debugger run on a remote host (see <a href="#Remote%20Debugging">Remote Debugging</a>), all commands to access the inferior debugger as well as its
2699
<p>When having the inferior debugger run on a remote host (see <a href="#Remote-Debugging">Remote Debugging</a>), all commands to access the inferior debugger as well as its
2838
2700
files must be run remotely. This is controlled by the following
2839
2701
resources (see <a href="#Customizing">Customizing</a>):
2840
2702
2841
<p>
2842
<table width="100%">
2843
<tr>
2844
<td align="left"><b>rshCommand</b><i> </i>(<i>class RshCommand</i>)<i>
2845
</i></td>
2846
<td align="right">Resource</td>
2847
</tr>
2848
</table>
2849
<table width="95%" align="center">
2850
<tr><td>
2851
The remote shell command to invoke <small>TTY</small>-based commands on
2852
remote hosts. Usually, <code>remsh</code>, <code>rsh</code>, <code>ssh</code>,
2853
or <code>on</code>.
2854
</td></tr>
2855
</table>
2856
2857
<p>
2858
<table width="100%">
2859
<tr>
2860
<td align="left"><b>listCoreCommand</b><i> </i>(<i>class listCoreCommand</i>)<i>
2861
</i></td>
2862
<td align="right">Resource</td>
2863
</tr>
2864
</table>
2865
<table width="95%" align="center">
2866
<tr><td>
2867
The command to list all core files on the remote host. The string
2868
<code>@MASK@</code> is replaced by a file filter. The default setting is:
2869
2703
<div class="defun">
2704
— Resource: <b>rshCommand</b> (<var>class RshCommand</var>)<var><a name="index-rshCommand-141"></a></var><br>
2705
<blockquote><p>The remote shell command to invoke <acronym>TTY</acronym>-based commands on
2706
remote hosts. Usually, <samp><span class="command">remsh</span></samp>, <samp><span class="command">rsh</span></samp>, <samp><span class="command">ssh</span></samp>,
2707
or <samp><span class="command">on</span></samp>.
2708
<a name="index-remsh-142"></a><a name="index-rsh-143"></a><a name="index-ssh-144"></a><a name="index-on-145"></a></p></blockquote></div>
2709
2710
<div class="defun">
2711
— Resource: <b>listCoreCommand</b> (<var>class listCoreCommand</var>)<var><a name="index-listCoreCommand-146"></a></var><br>
2712
<blockquote><p>The command to list all core files on the remote host. The string
2713
‘<samp><span class="samp">@MASK@</span></samp>’ is replaced by a file filter. The default setting is:
2714
2715
<p><a name="index-file-147"></a>
2870
2716
<pre class="example"> Ddd*listCoreCommand: \
2871
2717
file @MASK@ | grep '.*:.*core.*' | cut -d: -f1
2872
</pre>
2873
</td></tr>
2874
</table>
2875
2876
<p>
2877
<table width="100%">
2878
<tr>
2879
<td align="left"><b>listDirCommand</b><i> </i>(<i>class listDirCommand</i>)<i>
2880
</i></td>
2881
<td align="right">Resource</td>
2882
</tr>
2883
</table>
2884
<table width="95%" align="center">
2885
<tr><td>
2886
The command to list all directories on the remote host. The string
2887
<code>@MASK@</code> is replaced by a file filter. The default setting is:
2888
2718
</pre>
2719
</blockquote></div>
2720
2721
<div class="defun">
2722
— Resource: <b>listDirCommand</b> (<var>class listDirCommand</var>)<var><a name="index-listDirCommand-148"></a></var><br>
2723
<blockquote><p>The command to list all directories on the remote host. The string
2724
‘<samp><span class="samp">@MASK@</span></samp>’ is replaced by a file filter. The default setting is:
2725
2726
<p><a name="index-file-149"></a>
2889
2727
<pre class="example"> Ddd*listDirCommand: \
2890
2728
file @MASK@ | grep '.*:.*directory.*' | cut -d: -f1
2891
</pre>
2892
</td></tr>
2893
</table>
2894
2895
<p>
2896
<table width="100%">
2897
<tr>
2898
<td align="left"><b>listExecCommand</b><i> </i>(<i>class listExecCommand</i>)<i>
2899
</i></td>
2900
<td align="right">Resource</td>
2901
</tr>
2902
</table>
2903
<table width="95%" align="center">
2904
<tr><td>
2905
The command to list all executable files on the remote host. The string
2906
<code>@MASK@</code> is replaced by a file filter. The default setting is:
2907
2729
</pre>
2730
</blockquote></div>
2731
2732
<div class="defun">
2733
— Resource: <b>listExecCommand</b> (<var>class listExecCommand</var>)<var><a name="index-listExecCommand-150"></a></var><br>
2734
<blockquote><p>The command to list all executable files on the remote host. The string
2735
‘<samp><span class="samp">@MASK@</span></samp>’ is replaced by a file filter. The default setting is:
2736
2737
<p><a name="index-file-151"></a>
2908
2738
<pre class="example"> Ddd*listExecCommand: \
2909
2739
file @MASK@ | grep '.*:.*exec.*' \
2910
2740
| grep -v '.*:.*script.*' \
2911
2741
| cut -d: -f1 | grep -v '.*\.o$'
2912
</pre>
2913
</td></tr>
2914
</table>
2915
2916
<p>
2917
<table width="100%">
2918
<tr>
2919
<td align="left"><b>listSourceCommand</b><i> </i>(<i>class listSourceCommand</i>)<i>
2920
</i></td>
2921
<td align="right">Resource</td>
2922
</tr>
2923
</table>
2924
<table width="95%" align="center">
2925
<tr><td>
2926
The command to list all source files on the remote host. The string
2927
<code>@MASK@</code> is replaced by a file filter. The default setting is:
2928
2742
</pre>
2743
</blockquote></div>
2744
2745
<div class="defun">
2746
— Resource: <b>listSourceCommand</b> (<var>class listSourceCommand</var>)<var><a name="index-listSourceCommand-152"></a></var><br>
2747
<blockquote><p>The command to list all source files on the remote host. The string
2748
‘<samp><span class="samp">@MASK@</span></samp>’ is replaced by a file filter. The default setting is:
2749
2750
<p><a name="index-file-153"></a>
2929
2751
<pre class="example"> Ddd*listSourceCommand: \
2930
2752
file @MASK@ | grep '.*:.*text.*' | cut -d: -f1
2931
</pre>
2932
</td></tr>
2933
</table>
2753
</pre>
2754
</blockquote></div>
2934
2755
2935
2756
<div class="node">
2936
2757
<p><hr>
2937
<small class=header>
2938
Node:<a name="Remote%20Program">Remote Program</a>,
2939
Previous:<a rel="previous" accesskey="p" href="#Remote%20Debugger">Remote Debugger</a>,
2940
Up:<a rel="up" accesskey="u" href="#Remote%20Debugging">Remote Debugging</a>
2758
<a name="Remote-Program"></a>
2759
Previous: <a rel="previous" accesskey="p" href="#Remote-Debugger">Remote Debugger</a>,
2760
Up: <a rel="up" accesskey="u" href="#Remote-Debugging">Remote Debugging</a>
2941
2761
</small>
2942
2762
2943
<br>
2763
2944
2764
</div>
2945
2765
2946
<h4 class="subsection">Debugging a Remote Program</h4>
2766
<h4 class="subsection">2.4.3 Debugging a Remote Program</h4>
2947
2767
2948
<p>The <small>GDB</small> debugger allows you to run the <em>debugged program</em> on a
2949
remote machine (called <em>remote target</em>), while <small>GDB</small> runs on the
2768
<p><a name="index-Remote-program-154"></a><a name="index-Program_002c-on-remote-host-155"></a>
2769
The <acronym>GDB</acronym> debugger allows you to run the <em>debugged program</em> on a
2770
remote machine (called <em>remote target</em>), while <acronym>GDB</acronym> runs on the
2950
2771
local machine.
2951
2772
2952
2773
<p>See <a href="gdb.html#Remote">Remote Debugging</a>, for details. Basically, the following steps are required:
2954
2775
<ul>
2955
2776
<li>Transfer the executable to the remote target.
2956
2777
2957
<li>Start <code>gdbserver</code> on the remote target.
2958
2959
<li>Start <small>DDD</small> using <small>GDB</small> on the local machine, and load the same
2960
executable using the <small>GDB</small> <code>file</code> command.
2961
2962
<li>Attach to the remote <code>gdbserver</code> using the <small>GDB</small> <code>target remote</code>
2778
<li><a name="index-gdbserver-156"></a>Start <samp><span class="command">gdbserver</span></samp> on the remote target.
2779
2780
<li><a name="index-file-157"></a>Start <acronym>DDD</acronym> using <acronym>GDB</acronym> on the local machine, and load the same
2781
executable using the <acronym>GDB</acronym> <samp><span class="command">file</span></samp> command.
2782
2783
<li>Attach to the remote ‘<samp><span class="samp">gdbserver</span></samp>’ using the <acronym>GDB</acronym> <samp><span class="command">target remote</span></samp>
2963
2784
command.
2964
</ul>
2785
<a name="index-target-remote-158"></a></ul>
2965
2786
2966
<p>The local <code>.gdbinit</code> file is useful for setting up directory search
2787
<p><a name="index-g_t_002egdbinit-159"></a>The local <samp><span class="file">.gdbinit</span></samp> file is useful for setting up directory search
2967
2788
paths, etc.
2968
2789
2969
<p>Of course, you can also combine <small>DDD</small> remote mode and <small>GDB</small> remote
2970
mode, running <small>DDD</small>, <small>GDB</small>, and the debugged program each on a
2790
<p>Of course, you can also combine <acronym>DDD</acronym> remote mode and <acronym>GDB</acronym> remote
2791
mode, running <acronym>DDD</acronym>, <acronym>GDB</acronym>, and the debugged program each on a
2971
2792
different machine.
2972
2793
2973
2794
<div class="node">
2974
2795
<p><hr>
2975
<small class=header>
2976
Node:<a name="Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>,
2977
Previous:<a rel="previous" accesskey="p" href="#Remote%20Debugging">Remote Debugging</a>,
2978
Up:<a rel="up" accesskey="u" href="#Invocation">Invocation</a>
2796
<a name="Customizing-Debugger-Interaction"></a>
2797
Previous: <a rel="previous" accesskey="p" href="#Remote-Debugging">Remote Debugging</a>,
2798
Up: <a rel="up" accesskey="u" href="#Invocation">Invocation</a>
2979
2799
</small>
2980
2800
2981
<br>
2801
2982
2802
</div>
2983
2803
2984
<h3 class="section">Customizing Interaction with the Inferior Debugger</h3>
2804
<h3 class="section">2.5 Customizing Interaction with the Inferior Debugger</h3>
2985
2805
2986
<p>These settings control the interaction of <small>DDD</small> with its inferior
2806
<p>These settings control the interaction of <acronym>DDD</acronym> with its inferior
2987
2807
debugger.
2988
2808
2989
2809
<ul class="menu">
2990
<li><a accesskey="1" href="#Debugger%20Invocation">Debugger Invocation</a>:
2991
<li><a accesskey="2" href="#Debugger%20Initialization">Debugger Initialization</a>:
2992
<li><a accesskey="3" href="#Debugger%20Communication">Debugger Communication</a>:
2810
<li><a accesskey="1" href="#Debugger-Invocation">Debugger Invocation</a>
2811
<li><a accesskey="2" href="#Debugger-Initialization">Debugger Initialization</a>
2812
<li><a accesskey="3" href="#Debugger-Communication">Debugger Communication</a>
2993
2813
</ul>
2994
2814
2995
2815
<div class="node">
2996
2816
<p><hr>
2997
<small class=header>
2998
Node:<a name="Debugger%20Invocation">Debugger Invocation</a>,
2999
Next:<a rel="next" accesskey="n" href="#Debugger%20Initialization">Debugger Initialization</a>,
3000
Up:<a rel="up" accesskey="u" href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>
2817
<a name="Debugger-Invocation"></a>
2818
Next: <a rel="next" accesskey="n" href="#Debugger-Initialization">Debugger Initialization</a>,
2819
Up: <a rel="up" accesskey="u" href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>
3001
2820
</small>
3002
2821
3003
<br>
2822
3004
2823
</div>
3005
2824
3006
<h4 class="subsection">Invoking an Inferior Debugger</h4>
2825
<h4 class="subsection">2.5.1 Invoking an Inferior Debugger</h4>
3007
2826
3008
<p>To choose the default inferior debugger, select <code>Edit =>
3009
Preferences => Startup => Debugger Type</code>. You can
2827
<p><a name="index-Debugger-Type-160"></a>To choose the default inferior debugger, select ‘<samp><span class="samp">Edit
2828
Preferences Startup Debugger Type</span></samp>’. You can
3010
2829
3011
2830
<ul>
3012
<li>have <small>DDD</small> determine the appropriate inferior debugger
3013
automatically from its command-line arguments. Set <code>Determine
3014
Automatically from Arguments</code> to enable.
3015
<li>have <small>DDD</small> start the debugger of your choice, as specified in
3016
<code>Debugger Type</code>.
2831
<li><a name="index-Determine-Automatically-from-Arguments-161"></a>have <acronym>DDD</acronym> determine the appropriate inferior debugger
2832
automatically from its command-line arguments. Set ‘<samp><span class="samp">Determine
2833
Automatically from Arguments</span></samp>’ to enable.
2834
<li>have <acronym>DDD</acronym> start the debugger of your choice, as specified in
2835
‘<samp><span class="samp">Debugger Type</span></samp>’.
3017
2836
</ul>
3018
2837
3019
<p>The following <small>DDD</small> resources control the invocation of the
2838
<p>The following <acronym>DDD</acronym> resources control the invocation of the
3020
2839
inferior debugger (see <a href="#Customizing">Customizing</a>).
3021
2840
3022
<p>
3023
<table width="100%">
3024
<tr>
3025
<td align="left"><b>autoDebugger</b><i> </i>(<i>class AutoDebugger</i>)<i>
3026
</i></td>
3027
<td align="right">Resource</td>
3028
</tr>
3029
</table>
3030
<table width="95%" align="center">
3031
<tr><td>
3032
If this is <code>on</code> (default), <small>DDD</small> will attempt to determine
2841
<div class="defun">
2842
— Resource: <b>autoDebugger</b> (<var>class AutoDebugger</var>)<var><a name="index-autoDebugger-162"></a></var><br>
2843
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’ (default), <acronym>DDD</acronym> will attempt to determine
3033
2844
the debugger type from its arguments, possibly overriding the
3034
<code>debugger</code> resource (see below). If this is <code>off</code>,
3035
<small>DDD</small> will invoke the debugger specified by the <code>debugger</code>
3036
resource regardless of <small>DDD</small> arguments.
3037
</td></tr>
3038
</table>
3039
3040
<p>
3041
<table width="100%">
3042
<tr>
3043
<td align="left"><b>debugger</b><i> </i>(<i>class Debugger</i>)<i>
3044
</i></td>
3045
<td align="right">Resource</td>
3046
</tr>
3047
</table>
3048
<table width="95%" align="center">
3049
<tr><td>
3050
The type of the inferior debugger to invoke (<code>gdb</code>, <code>dbx</code>,
3051
<code>ladebug</code>, <code>xdb</code>, <code>jdb</code>, <code>pydb</code>, <code>perl</code>, or
3052
<code>bash</code>).
3053
3054
<p>This resource is usually set through the <code>--gdb</code>, <code>--dbx</code>,
3055
<code>--ladebug</code>, <code>--xdb</code>, <code>--jdb</code>, <code>--pydb</code>,
3056
<code>--perl</code>, and <code>--bash</code> options; See <a href="#Options">Options</a>, for details.
3057
</td></tr>
3058
</table>
3059
3060
<p>
3061
<table width="100%">
3062
<tr>
3063
<td align="left"><b>debuggerCommand</b><i> </i>(<i>class DebuggerCommand</i>)<i>
3064
</i></td>
3065
<td align="right">Resource</td>
3066
</tr>
3067
</table>
3068
<table width="95%" align="center">
3069
<tr><td>
3070
The name under which the inferior debugger is to be invoked. If this
3071
string is empty (default), the debugger type (<code>debugger</code> resource)
2845
‘<samp><span class="samp">debugger</span></samp>’ resource (see below). If this is ‘<samp><span class="samp">off</span></samp>’,
2846
<acronym>DDD</acronym> will invoke the debugger specified by the ‘<samp><span class="samp">debugger</span></samp>’
2847
resource regardless of <acronym>DDD</acronym> arguments.
2848
</p></blockquote></div>
2849
2850
<div class="defun">
2851
— Resource: <b>debugger</b> (<var>class Debugger</var>)<var><a name="index-debugger-163"></a></var><br>
2852
<blockquote><p>The type of the inferior debugger to invoke
2853
(‘<samp><span class="samp">bash</span></samp>’
2854
‘<samp><span class="samp">dbx</span></samp>’,
2855
‘<samp><span class="samp">gdb</span></samp>’,
2856
‘<samp><span class="samp">jdb</span></samp>’,
2857
‘<samp><span class="samp">ladebug</span></samp>’,
2858
‘<samp><span class="samp">make</span></samp>’,
2859
‘<samp><span class="samp">perl</span></samp>’,
2860
‘<samp><span class="samp">pydb</span></samp>’, or
2861
‘<samp><span class="samp">xdb</span></samp>’).
2862
2863
<p>This resource is usually set through the
2864
<samp><span class="option">--bash</span></samp>,
2865
<samp><span class="option">--dbx</span></samp>,
2866
<samp><span class="option">--gdb</span></samp>,
2867
<samp><span class="option">--jdb</span></samp>,
2868
<samp><span class="option">--ladebug</span></samp>,
2869
<samp><span class="option">--make</span></samp>,
2870
<samp><span class="option">--perl</span></samp>,
2871
<samp><span class="option">--pydb</span></samp>, and
2872
<samp><span class="option">--xdb</span></samp>,
2873
options; See <a href="#Options">Options</a>, for details.
2874
</p></blockquote></div>
2875
2876
<div class="defun">
2877
— Resource: <b>debuggerCommand</b> (<var>class DebuggerCommand</var>)<var><a name="index-debuggerCommand-164"></a></var><br>
2878
<blockquote><p>The name under which the inferior debugger is to be invoked. If this
2879
string is empty (default), the debugger type (‘<samp><span class="samp">debugger</span></samp>’ resource)
3072
2880
is used.
3073
2881
3074
<p>This resource is usually set through the <code>--debugger</code> option;
2882
<p>This resource is usually set through the <samp><span class="option">--debugger</span></samp> option;
3075
2883
See <a href="#Options">Options</a>, for details.
3076
</td></tr>
3077
</table>
2884
</p></blockquote></div>
3078
2885
3079
2886
<div class="node">
3080
2887
<p><hr>
3081
<small class=header>
3082
Node:<a name="Debugger%20Initialization">Debugger Initialization</a>,
3083
Next:<a rel="next" accesskey="n" href="#Debugger%20Communication">Debugger Communication</a>,
3084
Previous:<a rel="previous" accesskey="p" href="#Debugger%20Invocation">Debugger Invocation</a>,
3085
Up:<a rel="up" accesskey="u" href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>
2888
<a name="Debugger-Initialization"></a>
2889
Next: <a rel="next" accesskey="n" href="#Debugger-Communication">Debugger Communication</a>,
2890
Previous: <a rel="previous" accesskey="p" href="#Debugger-Invocation">Debugger Invocation</a>,
2891
Up: <a rel="up" accesskey="u" href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>
3086
2892
</small>
3087
2893
3088
<br>
2894
3089
2895
</div>
3090
2896
3091
<h4 class="subsection">Initializing the Inferior Debugger</h4>
2897
<h4 class="subsection">2.5.2 Initializing the Inferior Debugger</h4>
3092
2898
3093
<p><small>DDD</small> uses a number of resources to initialize the
2899
<p><acronym>DDD</acronym> uses a number of resources to initialize the
3094
2900
inferior debugger (see <a href="#Customizing">Customizing</a>).
3095
2901
3096
2902
<ul class="menu">
3097
<li><a accesskey="1" href="#GDB%20Initialization">GDB Initialization</a>:
3098
<li><a accesskey="2" href="#DBX%20Initialization">DBX Initialization</a>:
3099
<li><a accesskey="3" href="#XDB%20Initialization">XDB Initialization</a>:
3100
<li><a accesskey="4" href="#JDB%20Initialization">JDB Initialization</a>:
3101
<li><a accesskey="5" href="#PYDB%20Initialization">PYDB Initialization</a>:
3102
<li><a accesskey="6" href="#Perl%20Initialization">Perl Initialization</a>:
3103
<li><a accesskey="7" href="#Bash%20Initialization">Bash Initialization</a>:
3104
<li><a accesskey="8" href="#Finding%20a%20Place%20to%20Start">Finding a Place to Start</a>:
3105
<li><a accesskey="9" href="#Opening%20the%20Selection">Opening the Selection</a>:
2903
<li><a accesskey="1" href="#Bash-Initialization">Bash Initialization</a>
2904
<li><a accesskey="2" href="#DBX-Initialization">DBX Initialization</a>
2905
<li><a accesskey="3" href="#GDB-Initialization">GDB Initialization</a>
2906
<li><a accesskey="4" href="#JDB-Initialization">JDB Initialization</a>
2907
<li><a accesskey="5" href="#GNU-Make-Initialization">GNU Make Initialization</a>
2908
<li><a accesskey="6" href="#Perl-Initialization">Perl Initialization</a>
2909
<li><a accesskey="7" href="#PYDB-Initialization">PYDB Initialization</a>
2910
<li><a accesskey="8" href="#XDB-Initialization">XDB Initialization</a>
2911
<li><a accesskey="9" href="#Finding-a-Place-to-Start">Finding a Place to Start</a>
2912
<li><a href="#Opening-the-Selection">Opening the Selection</a>
3106
2913
</ul>
3107
2914
3108
2915
<div class="node">
3109
2916
<p><hr>
3110
<small class=header>
3111
Node:<a name="GDB%20Initialization">GDB Initialization</a>,
3112
Next:<a rel="next" accesskey="n" href="#DBX%20Initialization">DBX Initialization</a>,
3113
Up:<a rel="up" accesskey="u" href="#Debugger%20Initialization">Debugger Initialization</a>
3114
</small>
3115
3116
<br>
3117
</div>
3118
3119
<h5 class="subsubsection">GDB Initialization</h5>
3120
3121
<p>
3122
<table width="100%">
3123
<tr>
3124
<td align="left"><b>gdbInitCommands</b><i> </i>(<i>class InitCommands</i>)<i>
3125
</i></td>
3126
<td align="right">Resource</td>
3127
</tr>
3128
</table>
3129
<table width="95%" align="center">
3130
<tr><td>
3131
This string contains a list of newline-separated commands that are
3132
initially sent to <small>GDB</small>. As a side-effect, all settings
2917
<a name="Bash-Initialization"></a>
2918
Next: <a rel="next" accesskey="n" href="#DBX-Initialization">DBX Initialization</a>,
2919
Up: <a rel="up" accesskey="u" href="#Debugger-Initialization">Debugger Initialization</a>
2920
</small>
2921
2922
2923
</div>
2924
2925
<h5 class="subsubsection">2.5.2.1 Bash Initialization</h5>
2926
2927
<div class="defun">
2928
— Resource: <b>bashInitCommands</b> (<var>class InitCommands</var>)<var><a name="index-bashInitCommands-165"></a></var><br>
2929
<blockquote><p>This string contains a list of newline-separated commands that are
2930
initially sent to the Bash debugger. By default, it is empty.
2931
2932
<p>This resource may be used to customize the Bash debugger.
2933
</p></blockquote></div>
2934
2935
<div class="defun">
2936
— Resource: <b>bash</b> (<var>class Settings</var>)<var><a name="index-bash-166"></a></var><br>
2937
<blockquote><p>This string contains a list of newline-separated commands that are
2938
also initially sent to the Bash debugger. By default, it is empty.
2939
2940
<p>This resource is used by <acronym>DDD</acronym> to save and restore Bash
2941
debugger settings.
2942
</p></blockquote></div>
2943
2944
<div class="node">
2945
<p><hr>
2946
<a name="DBX-Initialization"></a>
2947
Next: <a rel="next" accesskey="n" href="#GDB-Initialization">GDB Initialization</a>,
2948
Previous: <a rel="previous" accesskey="p" href="#Bash-Initialization">Bash Initialization</a>,
2949
Up: <a rel="up" accesskey="u" href="#Debugger-Initialization">Debugger Initialization</a>
2950
</small>
2951
2952
2953
</div>
2954
2955
<h5 class="subsubsection">2.5.2.2 DBX Initialization</h5>
2956
2957
<div class="defun">
2958
— Resource: <b>dbxInitCommands</b> (<var>class InitCommands</var>)<var><a name="index-dbxInitCommands-167"></a></var><br>
2959
<blockquote><p>This string contains a list of newline-separated commands that are
2960
initially sent to <acronym>DBX</acronym>. By default, it is empty.
2961
2962
<p>Do not use this resource to customize <acronym>DBX</acronym>; instead, use a
2963
personal <samp><span class="file">~/.dbxinit</span></samp> or <samp><span class="file">~/.dbxrc</span></samp> file. See
2964
your <acronym>DBX</acronym> documentation for details.
2965
</p></blockquote></div>
2966
2967
<div class="defun">
2968
— Resource: <b>dbxSettings</b> (<var>class Settings</var>)<var><a name="index-dbxSettings-168"></a></var><br>
2969
<blockquote><p>This string contains a list of newline-separated commands that are
2970
also initially sent to <acronym>DBX</acronym>. By default, it is empty.
2971
</p></blockquote></div>
2972
2973
<div class="node">
2974
<p><hr>
2975
<a name="GDB-Initialization"></a>
2976
Next: <a rel="next" accesskey="n" href="#JDB-Initialization">JDB Initialization</a>,
2977
Previous: <a rel="previous" accesskey="p" href="#DBX-Initialization">DBX Initialization</a>,
2978
Up: <a rel="up" accesskey="u" href="#Debugger-Initialization">Debugger Initialization</a>
2979
</small>
2980
2981
2982
</div>
2983
2984
<h5 class="subsubsection">2.5.2.3 GDB Initialization</h5>
2985
2986
<div class="defun">
2987
— Resource: <b>gdbInitCommands</b> (<var>class InitCommands</var>)<var><a name="index-gdbInitCommands-169"></a></var><br>
2988
<blockquote><p>This string contains a list of newline-separated commands that are
2989
initially sent to <acronym>GDB</acronym>. As a side-effect, all settings
3133
2990
specified in this resource are considered fixed and cannot be changed
3134
through the <small>GDB</small> settings panel, unless preceded by white
3135
space. By default, the <code>gdbInitCommands</code> resource contains some
3136
settings vital to <small>DDD</small>:
2991
through the <acronym>GDB</acronym> settings panel, unless preceded by white
2992
space. By default, the ‘<samp><span class="samp">gdbInitCommands</span></samp>’ resource contains some
2993
settings vital to <acronym>DDD</acronym>:
3137
2994
3138
2995
<pre class="example"> Ddd*gdbInitCommands: \
3139
2996
set height 0\n\
3140
2997
set width 0\n\
3141
2998
set verbose off\n\
3142
2999
set prompt (gdb) \n
3143
</pre>
3144
3145
<p>While the <code>set height</code>, <code>set width</code>, and <code>set
3146
prompt</code> settings are fixed, the <code>set verbose</code> settings can be
3147
changed through the <small>GDB</small> settings panel (although being reset
3148
upon each new <small>DDD</small> invocation).
3149
3150
<p>Do not use this resource to customize <small>GDB</small>; instead, use a
3151
personal <code>~/.gdbinit</code> file. See your <small>GDB</small>
3000
</pre>
3001
<p>While the ‘<samp><span class="samp">set height</span></samp>’, ‘<samp><span class="samp">set width</span></samp>’, and ‘<samp><span class="samp">set
3002
prompt</span></samp>’ settings are fixed, the ‘<samp><span class="samp">set verbose</span></samp>’ settings can be
3003
changed through the <acronym>GDB</acronym> settings panel (although being reset
3004
upon each new <acronym>DDD</acronym> invocation).
3005
3006
<p>Do not use this resource to customize <acronym>GDB</acronym>; instead, use a
3007
personal <samp><span class="file">~/.gdbinit</span></samp> file. See your <acronym>GDB</acronym>
3152
3008
documentation for details.
3153
</td></tr>
3154
</table>
3009
</p></blockquote></div>
3155
3010
3156
<p>
3157
<table width="100%">
3158
<tr>
3159
<td align="left"><b>gdbSettings</b><i> </i>(<i>class Settings</i>)<i>
3160
</i></td>
3161
<td align="right">Resource</td>
3162
</tr>
3163
</table>
3164
<table width="95%" align="center">
3165
<tr><td>
3166
This string contains a list of newline-separated commands that are
3167
also initially sent to <small>GDB</small>. Its default value is
3011
<div class="defun">
3012
— Resource: <b>gdbSettings</b> (<var>class Settings</var>)<var><a name="index-gdbSettings-170"></a></var><br>
3013
<blockquote><p>This string contains a list of newline-separated commands that are
3014
also initially sent to <acronym>GDB</acronym>. Its default value is
3168
3015
3169
3016
<pre class="example"> Ddd*gdbSettings: \
3170
3017
set print asm-demangle on\n
3171
</pre>
3172
3173
<p>This resource is used to save and restore the debugger settings.
3174
</td></tr>
3175
</table>
3176
3177
<p>
3178
<table width="100%">
3179
<tr>
3180
<td align="left"><b>sourceInitCommands</b><i> </i>(<i>class SourceInitCommands</i>)<i>
3181
</i></td>
3182
<td align="right">Resource</td>
3183
</tr>
3184
</table>
3185
<table width="95%" align="center">
3186
<tr><td>
3187
If <code>on</code> (default), <small>DDD</small> writes all <small>GDB</small> initialization
3188
commands into a temporary file and makes <small>GDB</small> read this file, rather than
3018
</pre>
3019
<p>This resource is used to save and restore the debugger settings.
3020
</p></blockquote></div>
3021
3022
<div class="defun">
3023
— Resource: <b>sourceInitCommands</b> (<var>class SourceInitCommands</var>)<var><a name="index-sourceInitCommands-171"></a></var><br>
3024
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), <acronym>DDD</acronym> writes all <acronym>GDB</acronym> initialization
3025
commands into a temporary file and makes <acronym>GDB</acronym> read this file, rather than
3189
3026
sending each initialization command separately. This results in faster
3190
3027
startup (especially if you have several user-defined commands). If
3191
<code>off</code>, <small>DDD</small> makes <small>GDB</small> process each command separately.
3192
</td></tr>
3193
</table>
3194
3195
<div class="node">
3196
<p><hr>
3197
<small class=header>
3198
Node:<a name="DBX%20Initialization">DBX Initialization</a>,
3199
Next:<a rel="next" accesskey="n" href="#XDB%20Initialization">XDB Initialization</a>,
3200
Previous:<a rel="previous" accesskey="p" href="#GDB%20Initialization">GDB Initialization</a>,
3201
Up:<a rel="up" accesskey="u" href="#Debugger%20Initialization">Debugger Initialization</a>
3202
</small>
3203
3204
<br>
3205
</div>
3206
3207
<h5 class="subsubsection">DBX Initialization</h5>
3208
3209
<p>
3210
<table width="100%">
3211
<tr>
3212
<td align="left"><b>dbxInitCommands</b><i> </i>(<i>class InitCommands</i>)<i>
3213
</i></td>
3214
<td align="right">Resource</td>
3215
</tr>
3216
</table>
3217
<table width="95%" align="center">
3218
<tr><td>
3219
This string contains a list of newline-separated commands that are
3220
initially sent to <small>DBX</small>. By default, it is empty.
3221
3222
<p>Do not use this resource to customize <small>DBX</small>; instead, use a
3223
personal <code>~/.dbxinit</code> or <code>~/.dbxrc</code> file. See
3224
your <small>DBX</small> documentation for details.
3225
</td></tr>
3226
</table>
3227
3228
<p>
3229
<table width="100%">
3230
<tr>
3231
<td align="left"><b>dbxSettings</b><i> </i>(<i>class Settings</i>)<i>
3232
</i></td>
3233
<td align="right">Resource</td>
3234
</tr>
3235
</table>
3236
<table width="95%" align="center">
3237
<tr><td>
3238
This string contains a list of newline-separated commands that are
3239
also initially sent to <small>DBX</small>. By default, it is empty.
3240
</td></tr>
3241
</table>
3242
3243
<div class="node">
3244
<p><hr>
3245
<small class=header>
3246
Node:<a name="XDB%20Initialization">XDB Initialization</a>,
3247
Next:<a rel="next" accesskey="n" href="#JDB%20Initialization">JDB Initialization</a>,
3248
Previous:<a rel="previous" accesskey="p" href="#DBX%20Initialization">DBX Initialization</a>,
3249
Up:<a rel="up" accesskey="u" href="#Debugger%20Initialization">Debugger Initialization</a>
3250
</small>
3251
3252
<br>
3253
</div>
3254
3255
<h5 class="subsubsection">XDB Initialization</h5>
3256
3257
<p>
3258
<table width="100%">
3259
<tr>
3260
<td align="left"><b>xdbInitCommands</b><i> </i>(<i>class InitCommands</i>)<i>
3261
</i></td>
3262
<td align="right">Resource</td>
3263
</tr>
3264
</table>
3265
<table width="95%" align="center">
3266
<tr><td>
3267
This string contains a list of newline-separated commands that are
3268
initially sent to <small>XDB</small>. By default, it is empty.
3269
3270
<p>Do not use this resource to customize <small>DBX</small>; instead, use a
3271
personal <code>~/.xdbrc</code> file. See your <small>XDB</small>
3272
documentation for details.
3273
</td></tr>
3274
</table>
3275
3276
<p>
3277
<table width="100%">
3278
<tr>
3279
<td align="left"><b>xdbSettings</b><i> </i>(<i>class Settings</i>)<i>
3280
</i></td>
3281
<td align="right">Resource</td>
3282
</tr>
3283
</table>
3284
<table width="95%" align="center">
3285
<tr><td>
3286
This string contains a list of newline-separated commands that are
3287
also initially sent to <small>XDB</small>. By default, it is empty.
3288
</td></tr>
3289
</table>
3290
3291
<div class="node">
3292
<p><hr>
3293
<small class=header>
3294
Node:<a name="JDB%20Initialization">JDB Initialization</a>,
3295
Next:<a rel="next" accesskey="n" href="#PYDB%20Initialization">PYDB Initialization</a>,
3296
Previous:<a rel="previous" accesskey="p" href="#XDB%20Initialization">XDB Initialization</a>,
3297
Up:<a rel="up" accesskey="u" href="#Debugger%20Initialization">Debugger Initialization</a>
3298
</small>
3299
3300
<br>
3301
</div>
3302
3303
<h5 class="subsubsection">JDB Initialization</h5>
3304
3305
<p>
3306
<table width="100%">
3307
<tr>
3308
<td align="left"><b>jdbInitCommands</b><i> </i>(<i>class InitCommands</i>)<i>
3309
</i></td>
3310
<td align="right">Resource</td>
3311
</tr>
3312
</table>
3313
<table width="95%" align="center">
3314
<tr><td>
3315
This string contains a list of newline-separated commands that are
3316
initially sent to <small>JDB</small>. This resource may be used to customize
3317
<small>JDB</small>. By default, it is empty.
3318
</td></tr>
3319
</table>
3320
3321
<p>
3322
<table width="100%">
3323
<tr>
3324
<td align="left"><b>jdbSettings</b><i> </i>(<i>class Settings</i>)<i>
3325
</i></td>
3326
<td align="right">Resource</td>
3327
</tr>
3328
</table>
3329
<table width="95%" align="center">
3330
<tr><td>
3331
This string contains a list of newline-separated commands that are
3332
also initially sent to <small>JDB</small>. By default, it is empty.
3333
3334
<p>This resource is used by <small>DDD</small> to save and restore <small>JDB</small>
3335
settings.
3336
</td></tr>
3337
</table>
3338
3339
<div class="node">
3340
<p><hr>
3341
<small class=header>
3342
Node:<a name="PYDB%20Initialization">PYDB Initialization</a>,
3343
Next:<a rel="next" accesskey="n" href="#Perl%20Initialization">Perl Initialization</a>,
3344
Previous:<a rel="previous" accesskey="p" href="#JDB%20Initialization">JDB Initialization</a>,
3345
Up:<a rel="up" accesskey="u" href="#Debugger%20Initialization">Debugger Initialization</a>
3346
</small>
3347
3348
<br>
3349
</div>
3350
3351
<h5 class="subsubsection">PYDB Initialization</h5>
3352
3353
<p>
3354
<table width="100%">
3355
<tr>
3356
<td align="left"><b>pydbInitCommands</b><i> </i>(<i>class InitCommands</i>)<i>
3357
</i></td>
3358
<td align="right">Resource</td>
3359
</tr>
3360
</table>
3361
<table width="95%" align="center">
3362
<tr><td>
3363
This string contains a list of newline-separated commands that are
3364
initially sent to <small>PYDB</small>. By default, it is empty.
3365
3366
<p>This resource may be used to customize <small>PYDB</small>.
3367
</td></tr>
3368
</table>
3369
3370
<p>
3371
<table width="100%">
3372
<tr>
3373
<td align="left"><b>pydbSettings</b><i> </i>(<i>class Settings</i>)<i>
3374
</i></td>
3375
<td align="right">Resource</td>
3376
</tr>
3377
</table>
3378
<table width="95%" align="center">
3379
<tr><td>
3380
This string contains a list of newline-separated commands that are
3381
also initially sent to <small>PYDB</small>. By default, it is empty.
3382
3383
<p>This resource is used by <small>DDD</small> to save and restore <small>PYDB</small>
3384
settings.
3385
</td></tr>
3386
</table>
3387
3388
<div class="node">
3389
<p><hr>
3390
<small class=header>
3391
Node:<a name="Perl%20Initialization">Perl Initialization</a>,
3392
Next:<a rel="next" accesskey="n" href="#Bash%20Initialization">Bash Initialization</a>,
3393
Previous:<a rel="previous" accesskey="p" href="#PYDB%20Initialization">PYDB Initialization</a>,
3394
Up:<a rel="up" accesskey="u" href="#Debugger%20Initialization">Debugger Initialization</a>
3395
</small>
3396
3397
<br>
3398
</div>
3399
3400
<h5 class="subsubsection">Perl Initialization</h5>
3401
3402
<p>
3403
<table width="100%">
3404
<tr>
3405
<td align="left"><b>perlInitCommands</b><i> </i>(<i>class InitCommands</i>)<i>
3406
</i></td>
3407
<td align="right">Resource</td>
3408
</tr>
3409
</table>
3410
<table width="95%" align="center">
3411
<tr><td>
3412
This string contains a list of newline-separated commands that are
3028
‘<samp><span class="samp">off</span></samp>’, <acronym>DDD</acronym> makes <acronym>GDB</acronym> process each command separately.
3029
</p></blockquote></div>
3030
3031
<div class="node">
3032
<p><hr>
3033
<a name="JDB-Initialization"></a>
3034
Next: <a rel="next" accesskey="n" href="#GNU-Make-Initialization">GNU Make Initialization</a>,
3035
Previous: <a rel="previous" accesskey="p" href="#GDB-Initialization">GDB Initialization</a>,
3036
Up: <a rel="up" accesskey="u" href="#Debugger-Initialization">Debugger Initialization</a>
3037
</small>
3038
3039
3040
</div>
3041
3042
<h5 class="subsubsection">2.5.2.4 JDB Initialization</h5>
3043
3044
<div class="defun">
3045
— Resource: <b>jdbInitCommands</b> (<var>class InitCommands</var>)<var><a name="index-jdbInitCommands-172"></a></var><br>
3046
<blockquote><p>This string contains a list of newline-separated commands that are
3047
initially sent to <acronym>JDB</acronym>. This resource may be used to customize
3048
<acronym>JDB</acronym>. By default, it is empty.
3049
</p></blockquote></div>
3050
3051
<div class="defun">
3052
— Resource: <b>jdbSettings</b> (<var>class Settings</var>)<var><a name="index-jdbSettings-173"></a></var><br>
3053
<blockquote><p>This string contains a list of newline-separated commands that are
3054
also initially sent to <acronym>JDB</acronym>. By default, it is empty.
3055
3056
<p>This resource is used by <acronym>DDD</acronym> to save and restore <acronym>JDB</acronym>
3057
settings.
3058
</p></blockquote></div>
3059
3060
<div class="node">
3061
<p><hr>
3062
<a name="GNU-Make-Initialization"></a>
3063
Next: <a rel="next" accesskey="n" href="#Perl-Initialization">Perl Initialization</a>,
3064
Previous: <a rel="previous" accesskey="p" href="#JDB-Initialization">JDB Initialization</a>,
3065
Up: <a rel="up" accesskey="u" href="#Debugger-Initialization">Debugger Initialization</a>
3066
</small>
3067
3068
3069
</div>
3070
3071
<h5 class="subsubsection">2.5.2.5 GNU Make Initialization</h5>
3072
3073
<div class="defun">
3074
— Resource: <b>makeInitCommands</b> (<var>class InitCommands</var>)<var><a name="index-makeInitCommands-174"></a></var><br>
3075
<blockquote><p>This string contains a list of newline-separated commands that are
3076
initially sent to the Bash debugger. By default, it is empty.
3077
3078
<p>This resource may be used to customize GNU Make debugging.
3079
</p></blockquote></div>
3080
3081
<div class="defun">
3082
— Resource: <b>bash</b> (<var>class Settings</var>)<var><a name="index-bash-175"></a></var><br>
3083
<blockquote><p>This string contains a list of newline-separated commands that are
3084
also initially sent to the GNU Make debugger. By default, it is empty.
3085
3086
<p>This resource is used by <acronym>DDD</acronym> to save and restore GNU Make
3087
debugger settings.
3088
</p></blockquote></div>
3089
3090
<div class="node">
3091
<p><hr>
3092
<a name="Perl-Initialization"></a>
3093
Next: <a rel="next" accesskey="n" href="#PYDB-Initialization">PYDB Initialization</a>,
3094
Previous: <a rel="previous" accesskey="p" href="#GNU-Make-Initialization">GNU Make Initialization</a>,
3095
Up: <a rel="up" accesskey="u" href="#Debugger-Initialization">Debugger Initialization</a>
3096
</small>
3097
3098
3099
</div>
3100
3101
<h5 class="subsubsection">2.5.2.6 Perl Initialization</h5>
3102
3103
<div class="defun">
3104
— Resource: <b>perlInitCommands</b> (<var>class InitCommands</var>)<var><a name="index-perlInitCommands-176"></a></var><br>
3105
<blockquote><p>This string contains a list of newline-separated commands that are
3413
3106
initially sent to the Perl debugger. By default, it is empty.
3414
3107
3415
<p>This resource may be used to customize the Perl debugger.
3416
</td></tr>
3417
</table>
3418
3419
<p>
3420
<table width="100%">
3421
<tr>
3422
<td align="left"><b>perlSettings</b><i> </i>(<i>class Settings</i>)<i>
3423
</i></td>
3424
<td align="right">Resource</td>
3425
</tr>
3426
</table>
3427
<table width="95%" align="center">
3428
<tr><td>
3429
This string contains a list of newline-separated commands that are
3430
also initially sent to the Perl debugger. By default, it is empty.
3431
3432
<p>This resource is used by <small>DDD</small> to save and restore Perl
3433
debugger settings.
3434
</td></tr>
3435
</table>
3436
3437
<div class="node">
3438
<p><hr>
3439
<small class=header>
3440
Node:<a name="Bash%20Initialization">Bash Initialization</a>,
3441
Next:<a rel="next" accesskey="n" href="#Finding%20a%20Place%20to%20Start">Finding a Place to Start</a>,
3442
Previous:<a rel="previous" accesskey="p" href="#Perl%20Initialization">Perl Initialization</a>,
3443
Up:<a rel="up" accesskey="u" href="#Debugger%20Initialization">Debugger Initialization</a>
3444
</small>
3445
3446
<br>
3447
</div>
3448
3449
<h5 class="subsubsection">Bash Initialization</h5>
3450
3451
<p>
3452
<table width="100%">
3453
<tr>
3454
<td align="left"><b>bashInitCommands</b><i> </i>(<i>class InitCommands</i>)<i>
3455
</i></td>
3456
<td align="right">Resource</td>
3457
</tr>
3458
</table>
3459
<table width="95%" align="center">
3460
<tr><td>
3461
This string contains a list of newline-separated commands that are
3462
initially sent to the Bash debugger. By default, it is empty.
3463
3464
<p>This resource may be used to customize the Bash debugger.
3465
</td></tr>
3466
</table>
3467
3468
<p>
3469
<table width="100%">
3470
<tr>
3471
<td align="left"><b>bash</b><i> </i>(<i>class Settings</i>)<i>
3472
</i></td>
3473
<td align="right">Resource</td>
3474
</tr>
3475
</table>
3476
<table width="95%" align="center">
3477
<tr><td>
3478
This string contains a list of newline-separated commands that are
3479
also initially sent to the Perl debugger. By default, it is empty.
3480
3481
<p>This resource is used by <small>DDD</small> to save and restore Bash
3482
debugger settings.
3483
</td></tr>
3484
</table>
3485
3486
<div class="node">
3487
<p><hr>
3488
<small class=header>
3489
Node:<a name="Finding%20a%20Place%20to%20Start">Finding a Place to Start</a>,
3490
Next:<a rel="next" accesskey="n" href="#Opening%20the%20Selection">Opening the Selection</a>,
3491
Previous:<a rel="previous" accesskey="p" href="#Bash%20Initialization">Bash Initialization</a>,
3492
Up:<a rel="up" accesskey="u" href="#Debugger%20Initialization">Debugger Initialization</a>
3493
</small>
3494
3495
<br>
3496
</div>
3497
3498
<h5 class="subsubsection">Finding a Place to Start</h5>
3499
3500
<p>
3501
<table width="100%">
3502
<tr>
3503
<td align="left"><b>initSymbols</b><i> </i>(<i>class InitSymbols</i>)<i>
3504
</i></td>
3505
<td align="right">Resource</td>
3506
</tr>
3507
</table>
3508
<table width="95%" align="center">
3509
<tr><td>
3510
When loading an executable, <small>DDD</small> queries the inferior debugger for the
3511
initial source location--typically the <code>main</code> function. If this
3512
location is not found, <small>DDD</small> tries other symbols from this
3513
newline-separated list. The default value makes <small>DDD</small> look for a
3108
<p>This resource may be used to customize the Perl debugger.
3109
</p></blockquote></div>
3110
3111
<div class="defun">
3112
— Resource: <b>perlSettings</b> (<var>class Settings</var>)<var><a name="index-perlSettings-177"></a></var><br>
3113
<blockquote><p>This string contains a list of newline-separated commands that are
3114
also initially sent to the Perl debugger. By default, it is empty.
3115
3116
<p>This resource is used by <acronym>DDD</acronym> to save and restore Perl
3117
debugger settings.
3118
</p></blockquote></div>
3119
3120
<div class="node">
3121
<p><hr>
3122
<a name="PYDB-Initialization"></a>
3123
Next: <a rel="next" accesskey="n" href="#XDB-Initialization">XDB Initialization</a>,
3124
Previous: <a rel="previous" accesskey="p" href="#Perl-Initialization">Perl Initialization</a>,
3125
Up: <a rel="up" accesskey="u" href="#Debugger-Initialization">Debugger Initialization</a>
3126
</small>
3127
3128
3129
</div>
3130
3131
<h5 class="subsubsection">2.5.2.7 PYDB Initialization</h5>
3132
3133
<div class="defun">
3134
— Resource: <b>pydbInitCommands</b> (<var>class InitCommands</var>)<var><a name="index-pydbInitCommands-178"></a></var><br>
3135
<blockquote><p>This string contains a list of newline-separated commands that are
3136
initially sent to <code>pydb</code>. By default, it is empty.
3137
3138
<p>This resource may be used to customize <code>pydb</code>.
3139
</p></blockquote></div>
3140
3141
<div class="defun">
3142
— Resource: <b>pydbSettings</b> (<var>class Settings</var>)<var><a name="index-pydbSettings-179"></a></var><br>
3143
<blockquote><p>This string contains a list of newline-separated commands that are
3144
also initially sent to <code>pydb</code>. By default, it is empty.
3145
3146
<p>This resource is used by <acronym>DDD</acronym> to save and restore <code>pydb</code>
3147
settings.
3148
</p></blockquote></div>
3149
3150
<div class="node">
3151
<p><hr>
3152
<a name="XDB-Initialization"></a>
3153
Next: <a rel="next" accesskey="n" href="#Finding-a-Place-to-Start">Finding a Place to Start</a>,
3154
Previous: <a rel="previous" accesskey="p" href="#PYDB-Initialization">PYDB Initialization</a>,
3155
Up: <a rel="up" accesskey="u" href="#Debugger-Initialization">Debugger Initialization</a>
3156
</small>
3157
3158
3159
</div>
3160
3161
<h5 class="subsubsection">2.5.2.8 XDB Initialization</h5>
3162
3163
<div class="defun">
3164
— Resource: <b>xdbInitCommands</b> (<var>class InitCommands</var>)<var><a name="index-xdbInitCommands-180"></a></var><br>
3165
<blockquote><p>This string contains a list of newline-separated commands that are
3166
initially sent to <acronym>XDB</acronym>. By default, it is empty.
3167
3168
<p>Do not use this resource to customize <acronym>DBX</acronym>; instead, use a
3169
personal <samp><span class="file">~/.xdbrc</span></samp> file. See your <acronym>XDB</acronym>
3170
documentation for details.
3171
</p></blockquote></div>
3172
3173
<div class="defun">
3174
— Resource: <b>xdbSettings</b> (<var>class Settings</var>)<var><a name="index-xdbSettings-181"></a></var><br>
3175
<blockquote><p>This string contains a list of newline-separated commands that are
3176
also initially sent to <acronym>XDB</acronym>. By default, it is empty.
3177
</p></blockquote></div>
3178
3179
<div class="node">
3180
<p><hr>
3181
<a name="Finding-a-Place-to-Start"></a>
3182
Next: <a rel="next" accesskey="n" href="#Opening-the-Selection">Opening the Selection</a>,
3183
Previous: <a rel="previous" accesskey="p" href="#XDB-Initialization">XDB Initialization</a>,
3184
Up: <a rel="up" accesskey="u" href="#Debugger-Initialization">Debugger Initialization</a>
3185
</small>
3186
3187
3188
</div>
3189
3190
<h5 class="subsubsection">2.5.2.9 Finding a Place to Start</h5>
3191
3192
<div class="defun">
3193
— Resource: <b>initSymbols</b> (<var>class InitSymbols</var>)<var><a name="index-initSymbols-182"></a></var><br>
3194
<blockquote><p>When loading an executable, <acronym>DDD</acronym> queries the inferior debugger for the
3195
initial source location—typically the <code>main</code> function. If this
3196
location is not found, <acronym>DDD</acronym> tries other symbols from this
3197
newline-separated list. The default value makes <acronym>DDD</acronym> look for a
3514
3198
variety of main functions (especially FORTRAN main functions):
3515
3199
<pre class="example"> main\n\
3516
3200
MAIN\n\
3522
3206
_MAIN\n\
3523
3207
__main\n\
3524
3208
__MAIN
3525
</pre>
3526
</td></tr>
3527
</table>
3209
</pre>
3210
</blockquote></div>
3528
3211
3529
3212
<div class="node">
3530
3213
<p><hr>
3531
<small class=header>
3532
Node:<a name="Opening%20the%20Selection">Opening the Selection</a>,
3533
Previous:<a rel="previous" accesskey="p" href="#Finding%20a%20Place%20to%20Start">Finding a Place to Start</a>,
3534
Up:<a rel="up" accesskey="u" href="#Debugger%20Initialization">Debugger Initialization</a>
3214
<a name="Opening-the-Selection"></a>
3215
Previous: <a rel="previous" accesskey="p" href="#Finding-a-Place-to-Start">Finding a Place to Start</a>,
3216
Up: <a rel="up" accesskey="u" href="#Debugger-Initialization">Debugger Initialization</a>
3535
3217
</small>
3536
3218
3537
<br>
3219
3538
3220
</div>
3539
3221
3540
<h5 class="subsubsection">Opening the Selection</h5>
3222
<h5 class="subsubsection">2.5.2.10 Opening the Selection</h5>
3541
3223
3542
<p>
3543
<table width="100%">
3544
<tr>
3545
<td align="left"><b>openSelection</b><i> </i>(<i>class OpenSelection</i>)<i>
3546
</i></td>
3547
<td align="right">Resource</td>
3548
</tr>
3549
</table>
3550
<table width="95%" align="center">
3551
<tr><td>
3552
If this is <code>on</code>, <small>DDD</small> invoked without argument checks
3224
<div class="defun">
3225
— Resource: <b>openSelection</b> (<var>class OpenSelection</var>)<var><a name="index-openSelection-183"></a></var><br>
3226
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’, <acronym>DDD</acronym> invoked without argument checks
3553
3227
whether the current selection or clipboard contains the file name or
3554
URL of an executable program. If this is so, <small>DDD</small>
3228
URL of an executable program. If this is so, <acronym>DDD</acronym>
3555
3229
will automatically open this program for debugging. If this resource
3556
is <code>off</code> (default), <small>DDD</small> invoked without arguments will
3230
is ‘<samp><span class="samp">off</span></samp>’ (default), <acronym>DDD</acronym> invoked without arguments will
3557
3231
always start without a debugged program.
3558
</td></tr>
3559
</table>
3232
</p></blockquote></div>
3560
3233
3561
3234
<div class="node">
3562
3235
<p><hr>
3563
<small class=header>
3564
Node:<a name="Debugger%20Communication">Debugger Communication</a>,
3565
Previous:<a rel="previous" accesskey="p" href="#Debugger%20Initialization">Debugger Initialization</a>,
3566
Up:<a rel="up" accesskey="u" href="#Customizing%20Debugger%20Interaction">Customizing Debugger Interaction</a>
3236
<a name="Debugger-Communication"></a>
3237
Previous: <a rel="previous" accesskey="p" href="#Debugger-Initialization">Debugger Initialization</a>,
3238
Up: <a rel="up" accesskey="u" href="#Customizing-Debugger-Interaction">Customizing Debugger Interaction</a>
3567
3239
</small>
3568
3240
3569
<br>
3241
3570
3242
</div>
3571
3243
3572
<h4 class="subsection">Communication with the Inferior Debugger</h4>
3244
<h4 class="subsection">2.5.3 Communication with the Inferior Debugger</h4>
3573
3245
3574
<p>The following resources control the communication with the inferior
3246
<p>The following resources control the communication with the inferior
3575
3247
debugger.
3576
3248
3577
<p>
3578
<table width="100%">
3579
<tr>
3580
<td align="left"><b>blockTTYInput</b><i> </i>(<i>class BlockTTYInput</i>)<i>
3581
</i></td>
3582
<td align="right">Resource</td>
3583
</tr>
3584
</table>
3585
<table width="95%" align="center">
3586
<tr><td>
3587
Whether <small>DDD</small> should block when reading data from the inferior debugger
3588
via the pseudo-tty interface. Most <small>UNIX</small> systems except <small>GNU</small>/Linux
3589
<em>require</em> this; set it to <code>on</code>. On <small>GNU</small>/Linux, set it to
3590
<code>off</code>. The value <code>auto</code> (default) will always select the
3591
"best" choice (that is, the best choice known to the <small>DDD</small>
3249
<div class="defun">
3250
— Resource: <b>blockTTYInput</b> (<var>class BlockTTYInput</var>)<var><a name="index-blockTTYInput-184"></a></var><br>
3251
<blockquote><p>Whether <acronym>DDD</acronym> should block when reading data from the inferior debugger
3252
via the pseudo-tty interface. Most <acronym>UNIX</acronym> systems except <acronym>GNU</acronym>/Linux
3253
<em>require</em> this; set it to ‘<samp><span class="samp">on</span></samp>’. On <acronym>GNU</acronym>/Linux, set it to
3254
‘<samp><span class="samp">off</span></samp>’. The value ‘<samp><span class="samp">auto</span></samp>’ (default) will always select the
3255
“best” choice (that is, the best choice known to the <acronym>DDD</acronym>
3592
3256
developers).
3593
</td></tr>
3594
</table>
3257
</p></blockquote></div>
3595
3258
3596
<p>
3597
<table width="100%">
3598
<tr>
3599
<td align="left"><b>bufferGDBOutput</b><i> </i>(<i>class BufferGDBOutput</i>)<i>
3600
</i></td>
3601
<td align="right">Resource</td>
3602
</tr>
3603
</table>
3604
<table width="95%" align="center">
3605
<tr><td>
3606
If this is <code>on</code>, all output from the inferior debugger is buffered
3607
until a debugger prompt appears. This makes it easier for <small>DDD</small> to
3259
<div class="defun">
3260
— Resource: <b>bufferGDBOutput</b> (<var>class BufferGDBOutput</var>)<var><a name="index-bufferGDBOutput-185"></a></var><br>
3261
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’, all output from the inferior debugger is buffered
3262
until a debugger prompt appears. This makes it easier for <acronym>DDD</acronym> to
3608
3263
parse the output, but has the drawback that interaction with a running
3609
debuggee in the debugger console is not possible. If <code>off</code>, output
3264
debuggee in the debugger console is not possible. If ‘<samp><span class="samp">off</span></samp>’, output
3610
3265
is shown as soon as it arrives, enabling interaction, but making it
3611
harder for <small>DDD</small> to parse the output. If <code>auto</code> (default), output
3266
harder for <acronym>DDD</acronym> to parse the output. If ‘<samp><span class="samp">auto</span></samp>’ (default), output
3612
3267
is buffered if and only if the execution window is open, which redirects
3613
debuggee output and thus enables interaction. See <a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>, for details.
3614
</td></tr>
3615
</table>
3268
debuggee output and thus enables interaction. See <a href="#Using-the-Execution-Window">Using the Execution Window</a>, for details.
3269
</p></blockquote></div>
3616
3270
3617
<p>
3618
<table width="100%">
3619
<tr>
3620
<td align="left"><b>contInterruptDelay</b><i> </i>(<i>class InterruptDelay</i>)<i>
3621
</i></td>
3622
<td align="right">Resource</td>
3623
</tr>
3624
</table>
3625
<table width="95%" align="center">
3626
<tr><td>
3627
The time (in ms) to wait before automatically interrupting a <code>cont</code>
3628
command. <small>DDD</small> cannot interrupt a <code>cont</code> command immediately,
3271
<div class="defun">
3272
— Resource: <b>contInterruptDelay</b> (<var>class InterruptDelay</var>)<var><a name="index-contInterruptDelay-186"></a></var><br>
3273
<blockquote><p>The time (in ms) to wait before automatically interrupting a ‘<samp><span class="samp">cont</span></samp>’
3274
command. <acronym>DDD</acronym> cannot interrupt a ‘<samp><span class="samp">cont</span></samp>’ command immediately,
3629
3275
because this may disturb the status change of the process. Default is
3630
3276
<code>200</code>.
3631
</td></tr>
3632
</table>
3277
</p></blockquote></div>
3633
3278
3634
<p>
3635
<table width="100%">
3636
<tr>
3637
<td align="left"><b>displayTimeout</b><i> </i>(<i>class DisplayTimeout</i>)<i>
3638
</i></td>
3639
<td align="right">Resource</td>
3640
</tr>
3641
</table>
3642
<table width="95%" align="center">
3643
<tr><td>
3644
The time (in ms) to wait for the inferior debugger to finish a partial
3279
<div class="defun">
3280
— Resource: <b>displayTimeout</b> (<var>class DisplayTimeout</var>)<var><a name="index-displayTimeout-187"></a></var><br>
3281
<blockquote><p>The time (in ms) to wait for the inferior debugger to finish a partial
3645
3282
display information. Default is <code>2000</code>.
3646
</td></tr>
3647
</table>
3283
</p></blockquote></div>
3648
3284
3649
<p>
3650
<table width="100%">
3651
<tr>
3652
<td align="left"><b>positionTimeout</b><i> </i>(<i>class PositionTimeout</i>)<i>
3653
</i></td>
3654
<td align="right">Resource</td>
3655
</tr>
3656
</table>
3657
<table width="95%" align="center">
3658
<tr><td>
3659
The time (in ms) to wait for the inferior debugger to finish a partial
3285
<div class="defun">
3286
— Resource: <b>positionTimeout</b> (<var>class PositionTimeout</var>)<var><a name="index-positionTimeout-188"></a></var><br>
3287
<blockquote><p>The time (in ms) to wait for the inferior debugger to finish a partial
3660
3288
position information. Default is <code>500</code>.
3661
</td></tr>
3662
</table>
3289
</p></blockquote></div>
3663
3290
3664
<p>
3665
<table width="100%">
3666
<tr>
3667
<td align="left"><b>questionTimeout</b><i> </i>(<i>class QuestionTimeout</i>)<i>
3668
</i></td>
3669
<td align="right">Resource</td>
3670
</tr>
3671
</table>
3672
<table width="95%" align="center">
3673
<tr><td>
3674
The time (in seconds) to wait for the inferior debugger to reply.
3291
<div class="defun">
3292
— Resource: <b>questionTimeout</b> (<var>class QuestionTimeout</var>)<var><a name="index-questionTimeout-189"></a></var><br>
3293
<blockquote><p>The time (in seconds) to wait for the inferior debugger to reply.
3675
3294
Default is <code>10</code>.
3676
</td></tr>
3677
</table>
3295
</p></blockquote></div>
3678
3296
3679
<p>
3680
<table width="100%">
3681
<tr>
3682
<td align="left"><b>runInterruptDelay</b><i> </i>(<i>class InterruptDelay</i>)<i>
3683
</i></td>
3684
<td align="right">Resource</td>
3685
</tr>
3686
</table>
3687
<table width="95%" align="center">
3688
<tr><td>
3689
The time (in ms) to wait before automatically interrupting a <code>run</code>
3690
command. <small>DDD</small> cannot interrupt a <code>cont</code> command immediately,
3297
<div class="defun">
3298
— Resource: <b>runInterruptDelay</b> (<var>class InterruptDelay</var>)<var><a name="index-runInterruptDelay-190"></a></var><br>
3299
<blockquote><p>The time (in ms) to wait before automatically interrupting a ‘<samp><span class="samp">run</span></samp>’
3300
command. <acronym>DDD</acronym> cannot interrupt a ‘<samp><span class="samp">cont</span></samp>’ command immediately,
3691
3301
because this may disturb process creation. Default is <code>2000</code>.
3692
</td></tr>
3693
</table>
3302
</p></blockquote></div>
3694
3303
3695
<p>
3696
<table width="100%">
3697
<tr>
3698
<td align="left"><b>stopAndContinue</b><i> </i>(<i>class StopAndContinue</i>)<i>
3699
</i></td>
3700
<td align="right">Resource</td>
3701
</tr>
3702
</table>
3703
<table width="95%" align="center">
3704
<tr><td>
3705
If <code>on</code> (default), debugger commands interrupt program execution,
3304
<div class="defun">
3305
— Resource: <b>stopAndContinue</b> (<var>class StopAndContinue</var>)<var><a name="index-stopAndContinue-191"></a></var><br>
3306
<blockquote><p><a name="index-Interrupting-execution_002c-automatically-192"></a><a name="index-Execution_002c-interrupting-automatically-193"></a>If ‘<samp><span class="samp">on</span></samp>’ (default), debugger commands interrupt program execution,
3706
3307
resuming execution after the command has completed. This only happens
3707
if the last debugger command was either a <code>run</code> or a
3708
<code>continue</code> command. If <code>off</code>, debugger commands do not
3308
if the last debugger command was either a ‘<samp><span class="samp">run</span></samp>’ or a
3309
‘<samp><span class="samp">continue</span></samp>’ command. If ‘<samp><span class="samp">off</span></samp>’, debugger commands do not
3709
3310
interrupt program execution.
3710
</td></tr>
3711
</table>
3311
</p></blockquote></div>
3712
3312
3713
<p>
3714
<table width="100%">
3715
<tr>
3716
<td align="left"><b>synchronousDebugger</b><i> </i>(<i>class SynchronousDebugger</i>)<i>
3717
</i></td>
3718
<td align="right">Resource</td>
3719
</tr>
3720
</table>
3721
<table width="95%" align="center">
3722
<tr><td>
3723
If <code>on</code>, X events are not processed while the debugger is busy.
3313
<div class="defun">
3314
— Resource: <b>synchronousDebugger</b> (<var>class SynchronousDebugger</var>)<var><a name="index-synchronousDebugger-194"></a></var><br>
3315
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, X events are not processed while the debugger is busy.
3724
3316
This may result in slightly better performance on single-processor
3725
systems. See <a href="#Options">Options</a>, for the <code>--sync-debugger</code> option.
3726
</td></tr>
3727
</table>
3317
systems. See <a href="#Options">Options</a>, for the <samp><span class="option">--sync-debugger</span></samp> option.
3318
</p></blockquote></div>
3728
3319
3729
<p>
3730
<table width="100%">
3731
<tr>
3732
<td align="left"><b>terminateOnEOF</b><i> </i>(<i>class TerminateOnEOF</i>)<i>
3733
</i></td>
3734
<td align="right">Resource</td>
3735
</tr>
3736
</table>
3737
<table width="95%" align="center">
3738
<tr><td>
3739
If <code>on</code>, <small>DDD</small> terminates the inferior debugger when
3740
<small>DDD</small> detects an EOF condition (that is, as soon as the inferior
3320
<div class="defun">
3321
— Resource: <b>terminateOnEOF</b> (<var>class TerminateOnEOF</var>)<var><a name="index-terminateOnEOF-195"></a></var><br>
3322
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, <acronym>DDD</acronym> terminates the inferior debugger when
3323
<acronym>DDD</acronym> detects an EOF condition (that is, as soon as the inferior
3741
3324
debugger closes its output channel). This was the default behavior in
3742
<small>DDD</small> 2.x and earlier. If <code>off</code> (default), <small>DDD</small> takes
3325
<acronym>DDD</acronym> 2.x and earlier. If ‘<samp><span class="samp">off</span></samp>’ (default), <acronym>DDD</acronym> takes
3743
3326
no special action.
3744
</td></tr>
3745
</table>
3327
</p></blockquote></div>
3746
3328
3747
<p>
3748
<table width="100%">
3749
<tr>
3750
<td align="left"><b>useTTYCommand</b><i> </i>(<i>class UseTTYCommand</i>)<i>
3751
</i></td>
3752
<td align="right">Resource</td>
3753
</tr>
3754
</table>
3755
<table width="95%" align="center">
3756
<tr><td>
3757
If <code>on</code>, use the <small>GDB</small> <code>tty</code> command for redirecting
3758
input/output to the separate execution window. If <code>off</code>, use
3759
explicit redirection through shell redirection operators <code><</code> and
3760
<code>></code>. The default is <code>off</code> (explicit redirection), since on
3761
some systems, the <code>tty</code> command does not work properly on some
3762
<small>GDB</small> versions.
3763
</td></tr>
3764
</table>
3329
<div class="defun">
3330
— Resource: <b>useTTYCommand</b> (<var>class UseTTYCommand</var>)<var><a name="index-useTTYCommand-196"></a></var><br>
3331
<blockquote><p><a name="index-Redirection_002c-to-execution-window-197"></a><a name="index-tty-198"></a>If ‘<samp><span class="samp">on</span></samp>’, use the <acronym>GDB</acronym> <samp><span class="command">tty</span></samp> command for redirecting
3332
input/output to the separate execution window. If ‘<samp><span class="samp">off</span></samp>’, use
3333
explicit redirection through shell redirection operators ‘<samp><span class="samp"><</span></samp>’ and
3334
‘<samp><span class="samp">></span></samp>’. The default is ‘<samp><span class="samp">off</span></samp>’ (explicit redirection), since on
3335
some systems, the <samp><span class="command">tty</span></samp> command does not work properly on some
3336
<acronym>GDB</acronym> versions.
3337
</p></blockquote></div>
3765
3338
3766
3339
<div class="node">
3767
3340
<p><hr>
3768
<small class=header>
3769
Node:<a name="Windows">Windows</a>,
3770
Next:<a rel="next" accesskey="n" href="#Navigating">Navigating</a>,
3771
Previous:<a rel="previous" accesskey="p" href="#Invocation">Invocation</a>,
3772
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
3341
<a name="Windows"></a>
3342
Next: <a rel="next" accesskey="n" href="#Navigating">Navigating</a>,
3343
Previous: <a rel="previous" accesskey="p" href="#Invocation">Invocation</a>,
3344
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
3773
3345
</small>
3774
3346
3775
<br>
3347
3776
3348
</div>
3777
3349
3778
<h2 class="chapter">The DDD Windows</h2>
3350
<h2 class="chapter">3 The DDD Windows</h2>
3779
3351
3780
<p><small>DDD</small> is composed of three main windows. From top to bottom, we
3352
<p><acronym>DDD</acronym> is composed of three main windows. From top to bottom, we
3781
3353
have:
3782
3354
3783
3355
<ul>
3784
3356
<li>The <dfn>Data Window</dfn> shows the current data of the debugged program.
3785
See <a href="#Displaying%20Values">Displaying Values</a>, for details.
3786
<li>The <dfn>Source Window</dfn> shows the current source code of the debugged
3357
See <a href="#Displaying-Values">Displaying Values</a>, for details.
3358
<a name="index-Data-window-199"></a><li>The <dfn>Source Window</dfn> shows the current source code of the debugged
3787
3359
program. See <a href="#Navigating">Navigating</a>, for details.
3788
<li>The <dfn>Debugger Console</dfn> accepts debugger commands and shows debugger
3360
<a name="index-Source-window-200"></a><li>The <dfn>Debugger Console</dfn> accepts debugger commands and shows debugger
3789
3361
messages. See <a href="#Commands">Commands</a>, for details.
3790
</ul>
3791
3792
<br><p>
3362
<a name="index-Debugger-console-201"></a></ul>
3363
3364
<pre class="sp">
3365
3366
</pre>
3793
3367
<div align="center"><img src="PICS/ddd-all.jpg" alt="PICS/ddd-all.jpg"></div>
3794
<br><p>
3368
<pre class="sp">
3369
3370
</pre>
3371
3795
3372
<p>Besides these three main windows, there are some other optional windows:
3796
3373
3797
3374
<ul>
3798
3375
<li>The <dfn>Command Tool</dfn> offers buttons for frequently used commands.
3799
3376
It is usually placed on the source window.
3800
See <a href="#Command%20Tool">Command Tool</a>, for details.
3801
<li>The <dfn>Machine Code Window</dfn> shows the current machine code. It is
3802
usually placed beneath the current source. See <a href="#Machine%20Code">Machine Code</a>, for
3377
See <a href="#Command-Tool">Command Tool</a>, for details.
3378
<a name="index-Command-tool-202"></a><li>The <dfn>Machine Code Window</dfn> shows the current machine code. It is
3379
usually placed beneath the current source. See <a href="#Machine-Code">Machine Code</a>, for
3803
3380
details.
3804
<li>The <dfn>Execution Window</dfn> shows the input and output of the debugged
3805
program. See <a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>, for details.
3806
</ul>
3381
<a name="index-Machine-code-window-203"></a><li>The <dfn>Execution Window</dfn> shows the input and output of the debugged
3382
program. See <a href="#Using-the-Execution-Window">Using the Execution Window</a>, for details.
3383
<a name="index-Execution-window-204"></a></ul>
3807
3384
3808
3385
<ul class="menu">
3809
<li><a accesskey="1" href="#Menu%20Bar">Menu Bar</a>: All <small>DDD</small> pull-down menus.
3810
<li><a accesskey="2" href="#Tool%20Bar">Tool Bar</a>: The <small>DDD</small> icon buttons.
3811
<li><a accesskey="3" href="#Command%20Tool">Command Tool</a>: The floating command tool.
3812
<li><a accesskey="4" href="#Getting%20Help">Getting Help</a>: What does this thing mean?
3813
<li><a accesskey="5" href="#Undo%20and%20Redo">Undo and Redo</a>: Oops!
3814
<li><a accesskey="6" href="#Customizing">Customizing</a>: You can customize <small>DDD</small>
3386
<li><a accesskey="1" href="#Menu-Bar">Menu Bar</a>: All <acronym>DDD</acronym> pull-down menus.
3387
<li><a accesskey="2" href="#Tool-Bar">Tool Bar</a>: The <acronym>DDD</acronym> icon buttons.
3388
<li><a accesskey="3" href="#Command-Tool">Command Tool</a>: The floating command tool.
3389
<li><a accesskey="4" href="#Getting-Help">Getting Help</a>: What does this thing mean?
3390
<li><a accesskey="5" href="#Undo-and-Redo">Undo and Redo</a>: Oops!
3391
<li><a accesskey="6" href="#Customizing">Customizing</a>: You can customize <acronym>DDD</acronym>
3815
3392
</ul>
3816
3393
3817
3394
<div class="node">
3818
3395
<p><hr>
3819
<small class=header>
3820
Node:<a name="Menu%20Bar">Menu Bar</a>,
3821
Next:<a rel="next" accesskey="n" href="#Tool%20Bar">Tool Bar</a>,
3822
Up:<a rel="up" accesskey="u" href="#Windows">Windows</a>
3396
<a name="Menu-Bar"></a>
3397
Next: <a rel="next" accesskey="n" href="#Tool-Bar">Tool Bar</a>,
3398
Up: <a rel="up" accesskey="u" href="#Windows">Windows</a>
3823
3399
</small>
3824
3400
3825
<br>
3401
3826
3402
</div>
3827
3403
3828
<h3 class="section">The Menu Bar</h3>
3404
<h3 class="section">3.1 The Menu Bar</h3>
3829
3405
3830
<p>The <small>DDD</small> Menu Bar gives you access to all <small>DDD</small> functions.
3406
<p>The <acronym>DDD</acronym> Menu Bar gives you access to all <acronym>DDD</acronym> functions.
3831
3407
3832
3408
<dl>
3833
<dt><code>File</code>
3834
<dd>Perform file-related operations such as selecting programs, processes,
3409
<dt><code>File</code><dd><a name="index-File-205"></a>Perform file-related operations such as selecting programs, processes,
3835
3410
and sessions, printing graphs, recompiling, as well as exiting
3836
<small>DDD</small>.
3411
<acronym>DDD</acronym>.
3837
3412
3838
<br><dt><code>Edit</code>
3839
<dd>Perform standard editing operations, such as cutting, copying, pasting,
3840
and killing selected text. Also allows editing <small>DDD</small> options and
3413
<br><dt><code>Edit</code><dd><a name="index-Edit-206"></a>Perform standard editing operations, such as cutting, copying, pasting,
3414
and killing selected text. Also allows editing <acronym>DDD</acronym> options and
3841
3415
preferences.
3842
3416
3843
<br><dt><code>View</code>
3844
<dd>Allows accessing the individual <small>DDD</small> windows.
3417
<br><dt><code>View</code><dd><a name="index-View-207"></a>Allows accessing the individual <acronym>DDD</acronym> windows.
3845
3418
3846
<br><dt><code>Program</code>
3847
<dd>Perform operations related to the program being debugged, such as
3419
<br><dt><code>Program</code><dd><a name="index-Program-208"></a>Perform operations related to the program being debugged, such as
3848
3420
starting and stopping the program.
3849
3421
3850
<br><dt><code>Commands</code>
3851
<dd>Perform operations related to <small>DDD</small> commands, such as accessing
3422
<br><dt><code>Commands</code><dd><a name="index-Commands-209"></a>Perform operations related to <acronym>DDD</acronym> commands, such as accessing
3852
3423
the command history or defining new commands.
3853
3424
3854
<br><dt><code>Status</code>
3855
<dd>Examine the program status, such as the stack traces, registers, or
3425
<br><dt><code>Status</code><dd><a name="index-Status-210"></a>Examine the program status, such as the stack traces, registers, or
3856
3426
threads.
3857
3427
3858
<br><dt><code>Source</code>
3859
<dd>Perform source-related operations such as looking up items or editing
3428
<br><dt><code>Source</code><dd><a name="index-Source-211"></a>Perform source-related operations such as looking up items or editing
3860
3429
breakpoints.
3861
3430
3862
<br><dt><code>Data</code>
3863
<dd>Perform data-related operations such as editing displays or layouting
3431
<br><dt><code>Data</code><dd><a name="index-Data-212"></a>Perform data-related operations such as editing displays or layouting
3864
3432
the display graph.
3865
3433
3866
<br><dt><code>Maintenance</code>
3867
<dd>Perform operations that are useful for debugging <small>DDD</small>. By
3434
<br><dt><code>Maintenance</code><dd><a name="index-Maintenance-213"></a>Perform operations that are useful for debugging <acronym>DDD</acronym>. By
3868
3435
default, this menu is disabled.
3869
3436
3870
<br><dt><code>Help</code>
3871
<dd>Give help on <small>DDD</small> usage.
3437
<br><dt><code>Help</code><dd><a name="index-Help-214"></a>Give help on <acronym>DDD</acronym> usage.
3872
3438
</dl>
3873
3439
3874
3440
<p>There are two ways of selecting an item from a pull-down menu:
3890
3456
<p>If a command in the pull-down menu is not applicable in a given
3891
3457
situation, the command is <dfn>disabled</dfn> and its name appears faded.
3892
3458
You cannot invoke items that are faded. For example, many commands on
3893
the <code>Edit</code> menu appear faded until you select text on which they
3459
the ‘<samp><span class="samp">Edit</span></samp>’ menu appear faded until you select text on which they
3894
3460
are to operate; after you select a block of text, edit commands are
3895
3461
enabled.
3896
3462
3897
3463
<ul class="menu">
3898
<li><a accesskey="1" href="#File%20Menu">File Menu</a>: Selecting programs and processes.
3899
<li><a accesskey="2" href="#Edit%20Menu">Edit Menu</a>: Cut, copy, paste, and preferences.
3900
<li><a accesskey="3" href="#View%20Menu">View Menu</a>: All <small>DDD</small> windows.
3901
<li><a accesskey="4" href="#Program%20Menu">Program Menu</a>: Starting and stopping.
3902
<li><a accesskey="5" href="#Commands%20Menu">Commands Menu</a>: All <small>DDD</small> commands.
3903
<li><a accesskey="6" href="#Status%20Menu">Status Menu</a>: Examining the program status.
3904
<li><a accesskey="7" href="#Source%20Menu">Source Menu</a>: Navigating around.
3905
<li><a accesskey="8" href="#Data%20Menu">Data Menu</a>: Examining data.
3906
<li><a accesskey="9" href="#Maintenance%20Menu">Maintenance Menu</a>: Maintaining <small>DDD</small>.
3907
<li><a href="#Help%20Menu">Help Menu</a>: Getting help.
3908
<li><a href="#Customizing%20the%20Menu%20Bar">Customizing the Menu Bar</a>: Alternate key bindings, etc.
3464
<li><a accesskey="1" href="#File-Menu">File Menu</a>: Selecting programs and processes.
3465
<li><a accesskey="2" href="#Edit-Menu">Edit Menu</a>: Cut, copy, paste, and preferences.
3466
<li><a accesskey="3" href="#View-Menu">View Menu</a>: All <acronym>DDD</acronym> windows.
3467
<li><a accesskey="4" href="#Program-Menu">Program Menu</a>: Starting and stopping.
3468
<li><a accesskey="5" href="#Commands-Menu">Commands Menu</a>: All <acronym>DDD</acronym> commands.
3469
<li><a accesskey="6" href="#Status-Menu">Status Menu</a>: Examining the program status.
3470
<li><a accesskey="7" href="#Source-Menu">Source Menu</a>: Navigating around.
3471
<li><a accesskey="8" href="#Data-Menu">Data Menu</a>: Examining data.
3472
<li><a accesskey="9" href="#Maintenance-Menu">Maintenance Menu</a>: Maintaining <acronym>DDD</acronym>.
3473
<li><a href="#Help-Menu">Help Menu</a>: Getting help.
3474
<li><a href="#Customizing-the-Menu-Bar">Customizing the Menu Bar</a>: Alternate key bindings, etc.
3909
3475
</ul>
3910
3476
3911
3477
<div class="node">
3912
3478
<p><hr>
3913
<small class=header>
3914
Node:<a name="File%20Menu">File Menu</a>,
3915
Next:<a rel="next" accesskey="n" href="#Edit%20Menu">Edit Menu</a>,
3916
Up:<a rel="up" accesskey="u" href="#Menu%20Bar">Menu Bar</a>
3479
<a name="File-Menu"></a>
3480
Next: <a rel="next" accesskey="n" href="#Edit-Menu">Edit Menu</a>,
3481
Up: <a rel="up" accesskey="u" href="#Menu-Bar">Menu Bar</a>
3917
3482
</small>
3918
3483
3919
<br>
3484
3920
3485
</div>
3921
3486
3922
<h4 class="subsection">The File Menu</h4>
3487
<h4 class="subsection">3.1.1 The File Menu</h4>
3923
3488
3924
<p>The <code>File</code> menu contains file-related operations such as selecting
3489
<p><a name="index-File-215"></a>
3490
The ‘<samp><span class="samp">File</span></samp>’ menu contains file-related operations such as selecting
3925
3491
programs, processes, and sessions, printing graphs, recompiling, as well
3926
as exiting <small>DDD</small>.
3492
as exiting <acronym>DDD</acronym>.
3927
3493
3928
3494
<dl>
3929
<dt><code>Open Program</code>
3930
<dd><dt><code>Open Class</code>
3931
<dd>Open a program or class to be debugged (<Ctrl+O>). See <a href="#Opening%20Programs">Opening Programs</a>, for details.
3932
3933
<br><dt><code>Open Recent</code>
3934
<dd>Re-open a recently opened program to be debugged. See <a href="#Opening%20Programs">Opening Programs</a>, for details.
3935
3936
<br><dt><code>Open Core Dump</code>
3937
<dd>Open a core dump for the currently debugged program. See <a href="#Opening%20Core%20Dumps">Opening Core Dumps</a>, for details.
3938
3939
<br><dt><code>Open Source</code>
3940
<dd>Open a source file of the currently debugged program. See <a href="#Opening%20Source%20Files">Opening Source Files</a>, for details.
3941
3942
<br><dt><code>Open Session</code>
3943
<dd>Resume a previously saved <small>DDD</small> session (<Ctrl+N>). See <a href="#Resuming%20Sessions">Resuming Sessions</a>, for details.
3944
3945
<br><dt><code>Save Session As</code>
3946
<dd>Save the current <small>DDD</small> session such that you can resume it later
3947
(<Ctrl+S>). See <a href="#Saving%20Sessions">Saving Sessions</a>, for details.
3948
3949
<br><dt><code>Attach to Process</code>
3950
<dd>Attach to a running process of the debugged program. See <a href="#Attaching%20to%20a%20Process">Attaching to a Process</a>, for details.
3951
3952
<br><dt><code>Detach Process</code>
3953
<dd>Detach from the running process. See <a href="#Attaching%20to%20a%20Process">Attaching to a Process</a>, for
3954
details.
3955
3956
<br><dt><code>Print Graph</code>
3957
<dd>Print the current graph on a printer. See <a href="#Printing%20the%20Graph">Printing the Graph</a>, for
3958
details.
3959
3960
<br><dt><code>Change Directory</code>
3961
<dd>Change the working directory of your program. See <a href="#Working%20Directory">Working Directory</a>,
3495
<dt><code>Open Program</code><dt><code>Open Class</code><dd><a name="index-Ctrl_002bO-216"></a><a name="index-Open-Program-217"></a><a name="index-Open-Class-218"></a>Open a program or class to be debugged (<Ctrl+O>). See <a href="#Opening-Programs">Opening Programs</a>, for details.
3496
3497
<br><dt><code>Open Recent</code><dd><a name="index-Open-Recent-219"></a>Re-open a recently opened program to be debugged. See <a href="#Opening-Programs">Opening Programs</a>, for details.
3498
3499
<br><dt><code>Open Core Dump</code><dd><a name="index-Open-Core-Dump-220"></a>Open a core dump for the currently debugged program. See <a href="#Opening-Core-Dumps">Opening Core Dumps</a>, for details.
3500
3501
<br><dt><code>Open Source</code><dd><a name="index-Open-Source-221"></a>Open a source file of the currently debugged program. See <a href="#Opening-Source-Files">Opening Source Files</a>, for details.
3502
3503
<br><dt><code>Open Session</code><dd><a name="index-Open-Session-222"></a><a name="index-Ctrl_002bN-223"></a>Resume a previously saved <acronym>DDD</acronym> session (<Ctrl+N>). See <a href="#Resuming-Sessions">Resuming Sessions</a>, for details.
3504
3505
<br><dt><code>Save Session As</code><dd><a name="index-Save-Session-As-224"></a><a name="index-Ctrl_002bS-225"></a>Save the current <acronym>DDD</acronym> session such that you can resume it later
3506
(<Ctrl+S>). See <a href="#Saving-Sessions">Saving Sessions</a>, for details.
3507
3508
<br><dt><code>Attach to Process</code><dd><a name="index-Attach-to-Process-226"></a>Attach to a running process of the debugged program. See <a href="#Attaching-to-a-Process">Attaching to a Process</a>, for details.
3509
3510
<br><dt><code>Detach Process</code><dd><a name="index-Detach-Process-227"></a>Detach from the running process. See <a href="#Attaching-to-a-Process">Attaching to a Process</a>, for
3511
details.
3512
3513
<br><dt><code>Print Graph</code><dd><a name="index-Print-Graph-228"></a>Print the current graph on a printer. See <a href="#Printing-the-Graph">Printing the Graph</a>, for
3514
details.
3515
3516
<br><dt><code>Change Directory</code><dd><a name="index-Change-Directory-229"></a>Change the working directory of your program. See <a href="#Working-Directory">Working Directory</a>,
3962
3517
for details.
3963
3518
3964
<br><dt><code>Make</code>
3965
<dd>Run the <code>make</code> program (<Ctrl+M>). See <a href="#Recompiling">Recompiling</a>, for
3519
<br><dt><code>Make</code><dd><a name="index-Make-230"></a><a name="index-Ctrl_002bM-231"></a>Run the <code>make</code> program (<Ctrl+M>). See <a href="#Recompiling">Recompiling</a>, for
3966
3520
details.
3967
3521
3968
<br><dt><code>Close</code>
3969
<dd>Close this <small>DDD</small> window (<Ctrl+W>). See <a href="#Quitting">Quitting</a>, for details.
3970
3971
<br><dt><code>Restart</code>
3972
<dd>Restart <small>DDD</small>.
3973
3974
<br><dt><code>Exit</code>
3975
<dd>Exit <small>DDD</small> (<Ctrl+Q>). See <a href="#Quitting">Quitting</a>, for details.
3522
<br><dt><code>Close</code><dd><a name="index-Close-232"></a><a name="index-Ctrl_002bW-233"></a>Close this <acronym>DDD</acronym> window (<Ctrl+W>). See <a href="#Quitting">Quitting</a>, for details.
3523
3524
<br><dt><code>Restart</code><dd><a name="index-Restart-234"></a>Restart <acronym>DDD</acronym>.
3525
3526
<br><dt><code>Exit</code><dd><a name="index-Exit-235"></a><a name="index-Ctrl_002bQ-236"></a>Exit <acronym>DDD</acronym> (<Ctrl+Q>). See <a href="#Quitting">Quitting</a>, for details.
3976
3527
</dl>
3977
3528
3978
3529
<div class="node">
3979
3530
<p><hr>
3980
<small class=header>
3981
Node:<a name="Edit%20Menu">Edit Menu</a>,
3982
Next:<a rel="next" accesskey="n" href="#View%20Menu">View Menu</a>,
3983
Previous:<a rel="previous" accesskey="p" href="#File%20Menu">File Menu</a>,
3984
Up:<a rel="up" accesskey="u" href="#Menu%20Bar">Menu Bar</a>
3531
<a name="Edit-Menu"></a>
3532
Next: <a rel="next" accesskey="n" href="#View-Menu">View Menu</a>,
3533
Previous: <a rel="previous" accesskey="p" href="#File-Menu">File Menu</a>,
3534
Up: <a rel="up" accesskey="u" href="#Menu-Bar">Menu Bar</a>
3985
3535
</small>
3986
3536
3987
<br>
3537
3988
3538
</div>
3989
3539
3990
<h4 class="subsection">The Edit Menu</h4>
3540
<h4 class="subsection">3.1.2 The Edit Menu</h4>
3991
3541
3992
<p>The <code>Edit</code> menu contains standard editing operations, such as
3542
<p><a name="index-Edit-237"></a><a name="index-Clipboard-238"></a>
3543
The ‘<samp><span class="samp">Edit</span></samp>’ menu contains standard editing operations, such as
3993
3544
cutting, copying, pasting, and killing selected text. Also allows
3994
editing <small>DDD</small> options and preferences.
3545
editing <acronym>DDD</acronym> options and preferences.
3995
3546
3996
3547
<dl>
3997
<dt><code>Undo</code>
3998
<dd>Undo the most recent action (<Ctrl+Z>). Almost all commands can be
3999
undone this way. See <a href="#Undo%20and%20Redo">Undo and Redo</a>, for details.
4000
4001
<br><dt><code>Redo</code>
4002
<dd>Redo the action most recently undone (<Ctrl+Y>). Every command
4003
undone can be redone this way. See <a href="#Undo%20and%20Redo">Undo and Redo</a>, for details.
4004
4005
<br><dt><code>Cut</code>
4006
<dd>Removes the selected text block from the current text area and makes it
3548
<dt><code>Undo</code><dd><a name="index-Undo-239"></a><a name="index-Ctrl_002bZ-240"></a>Undo the most recent action (<Ctrl+Z>). Almost all commands can be
3549
undone this way. See <a href="#Undo-and-Redo">Undo and Redo</a>, for details.
3550
3551
<br><dt><code>Redo</code><dd><a name="index-Redo-241"></a><a name="index-Ctrl_002bY-242"></a>Redo the action most recently undone (<Ctrl+Y>). Every command
3552
undone can be redone this way. See <a href="#Undo-and-Redo">Undo and Redo</a>, for details.
3553
3554
<br><dt><code>Cut</code><dd><a name="index-Cut-243"></a><a name="index-Ctrl_002bX-244"></a><a name="index-Shift_002bDel-245"></a>Removes the selected text block from the current text area and makes it
4007
3555
the X clipboard selection (<Ctrl+X> or <Shift+Del>;
4008
See <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>, for details). Before executing this
4009
command, you have to select a region in a text area--either with the
3556
See <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a>, for details). Before executing this
3557
command, you have to select a region in a text area—either with the
4010
3558
mouse or with the usual text selection keys.
4011
3559
4012
<p>This item can also be applied to displays (see <a href="#Deleting%20Displays">Deleting Displays</a>).
3560
<p>This item can also be applied to displays (see <a href="#Deleting-Displays">Deleting Displays</a>).
4013
3561
4014
<br><dt><code>Copy</code>
4015
<dd>Makes a selected text block the X clipboard selection (<Ctrl+C> or
4016
<Ctrl+Ins>; See <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>, for details). You
3562
<br><dt><code>Copy</code><dd><a name="index-Copy-246"></a><a name="index-Ctrl_002bC-247"></a><a name="index-Ctrl_002bIns-248"></a>Makes a selected text block the X clipboard selection (<Ctrl+C> or
3563
<Ctrl+Ins>; See <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a>, for details). You
4017
3564
can select text by selecting a text region with the usual text selection
4018
keys or with the mouse. See <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>, for changing
3565
keys or with the mouse. See <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a>, for changing
4019
3566
the default accelerator.
4020
3567
4021
<p>This item can also be applied to displays (see <a href="#Deleting%20Displays">Deleting Displays</a>).
3568
<p>This item can also be applied to displays (see <a href="#Deleting-Displays">Deleting Displays</a>).
4022
3569
4023
<br><dt><code>Paste</code>
4024
<dd>Inserts the current value of the X clipboard selection in the most
3570
<br><dt><code>Paste</code><dd><a name="index-Paste-249"></a><a name="index-Ctrl_002bV-250"></a><a name="index-Shift_002bIns-251"></a>Inserts the current value of the X clipboard selection in the most
4025
3571
recently selected text area (<Ctrl+V> or <Shift+Ins>;
4026
See <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>, for details). You can paste in text
4027
you have placed in the clipboard using <code>Copy</code> or <code>Cut</code>. You
4028
can also use <code>Paste</code> to insert text that was pasted into the
3572
See <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a>, for details). You can paste in text
3573
you have placed in the clipboard using ‘<samp><span class="samp">Copy</span></samp>’ or ‘<samp><span class="samp">Cut</span></samp>’. You
3574
can also use ‘<samp><span class="samp">Paste</span></samp>’ to insert text that was pasted into the
4029
3575
clipboard from other applications.
4030
3576
4031
<br><dt><code>Clear</code>
4032
<dd>Clears the most recently selected text area (<Ctrl+U>).
3577
<br><dt><code>Clear</code><dd><a name="index-Clear-252"></a><a name="index-Ctrl_002bU-253"></a>Clears the most recently selected text area (<Ctrl+U>).
4033
3578
4034
<br><dt><code>Delete</code>
4035
<dd>Removes the selected text block from the most recently selected text
3579
<br><dt><code>Delete</code><dd><a name="index-Delete-254"></a>Removes the selected text block from the most recently selected text
4036
3580
area, but does not make it the X clipboard selection.
4037
3581
4038
<p>This item can also be applied to displays (see <a href="#Deleting%20Displays">Deleting Displays</a>).
4039
4040
<br><dt><code>Select All</code>
4041
<dd>Selects all characters from the most recently selected text area
4042
(<Ctrl+A> or or <Ctrl+Shift+A>; see <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>, for details).
4043
4044
<br><dt><code>Preferences</code>
4045
<dd>Allows you to customize <small>DDD</small> interactively. See <a href="#Customizing">Customizing</a>,
3582
<p>This item can also be applied to displays (see <a href="#Deleting-Displays">Deleting Displays</a>).
3583
3584
<br><dt><code>Select All</code><dd><a name="index-Select-All-255"></a><a name="index-Ctrl_002bA-256"></a><a name="index-Ctrl_002bShift_002bA-257"></a>Selects all characters from the most recently selected text area
3585
(<Ctrl+A> or or <Ctrl+Shift+A>; see <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a>, for details).
3586
3587
<br><dt><code>Preferences</code><dd><a name="index-Preferences-258"></a>Allows you to customize <acronym>DDD</acronym> interactively. See <a href="#Customizing">Customizing</a>,
4046
3588
for details.
4047
3589
4048
<br><dt><code>Debugger Settings</code>
4049
<dd>Allows you to customize the inferior debugger. See <a href="#Debugger%20Settings">Debugger Settings</a>, for details.
3590
<br><dt><code>Debugger Settings</code><dd><a name="index-Debugger-Settings-259"></a><a name="index-GDB-Settings-260"></a><a name="index-DBX-Settings-261"></a><a name="index-Ladebug-Settings-262"></a><a name="index-XDB-Settings-263"></a><a name="index-JDB-Settings-264"></a><a name="index-PYDB-Settings-265"></a><a name="index-Perl-Settings-266"></a>Allows you to customize the inferior debugger. See <a href="#Debugger-Settings">Debugger Settings</a>, for details.
4050
3591
4051
<br><dt><code>Save Options</code>
4052
<dd>If set, all preferences and settings will be saved for the next <small>DDD</small>
4053
invocation. See <a href="#Saving%20Options">Saving Options</a>, for details.
3592
<br><dt><code>Save Options</code><dd><a name="index-Save-Options-267"></a>If set, all preferences and settings will be saved for the next <acronym>DDD</acronym>
3593
invocation. See <a href="#Saving-Options">Saving Options</a>, for details.
4054
3594
</dl>
4055
3595
4056
3596
<div class="node">
4057
3597
<p><hr>
4058
<small class=header>
4059
Node:<a name="View%20Menu">View Menu</a>,
4060
Next:<a rel="next" accesskey="n" href="#Program%20Menu">Program Menu</a>,
4061
Previous:<a rel="previous" accesskey="p" href="#Edit%20Menu">Edit Menu</a>,
4062
Up:<a rel="up" accesskey="u" href="#Menu%20Bar">Menu Bar</a>
3598
<a name="View-Menu"></a>
3599
Next: <a rel="next" accesskey="n" href="#Program-Menu">Program Menu</a>,
3600
Previous: <a rel="previous" accesskey="p" href="#Edit-Menu">Edit Menu</a>,
3601
Up: <a rel="up" accesskey="u" href="#Menu-Bar">Menu Bar</a>
4063
3602
</small>
4064
3603
4065
<br>
3604
4066
3605
</div>
4067
3606
4068
<h4 class="subsection">The View Menu</h4>
3607
<h4 class="subsection">3.1.3 The View Menu</h4>
4069
3608
4070
<p>The <code>View</code> menu allows accessing the individual <small>DDD</small>
3609
<p><a name="index-View-268"></a>
3610
The ‘<samp><span class="samp">View</span></samp>’ menu allows accessing the individual <acronym>DDD</acronym>
4071
3611
windows.
4072
3612
4073
3613
<dl>
4074
<dt><code>Command Tool</code>
4075
<dd>Open and recenter the command tool (<Alt+8>). See <a href="#Command%20Tool">Command Tool</a>,
3614
<dt><code>Command Tool</code><dd><a name="index-Command-Tool-269"></a><a name="index-Alt_002b8-270"></a>Open and recenter the command tool (<Alt+8>). See <a href="#Command-Tool">Command Tool</a>,
4076
3615
for details.
4077
3616
4078
<br><dt><code>Execution Window</code>
4079
<dd>Open the separate execution window (<Alt+9>). See <a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>, for details.
4080
4081
<br><dt><code>Debugger Console</code>
4082
<dd>Open the debugger console (<Alt+1>). See <a href="#Commands">Commands</a>, for details.
4083
4084
<br><dt><code>Source Window</code>
4085
<dd>Open the source window (<Alt+2>). See <a href="#Navigating">Navigating</a>, for details.
4086
4087
<br><dt><code>Data Window</code>
4088
<dd>Open the data window (<Alt+3>). See <a href="#Displaying%20Values">Displaying Values</a>, for details.
4089
4090
<br><dt><code>Machine Code Window</code>
4091
<dd>Show machine code (<Alt+4>). See <a href="#Machine%20Code">Machine Code</a>, for details.
3617
<br><dt><code>Execution Window</code><dd><a name="index-Execution-Window-271"></a><a name="index-Alt_002b9-272"></a>Open the separate execution window (<Alt+9>). See <a href="#Using-the-Execution-Window">Using the Execution Window</a>, for details.
3618
3619
<br><dt><code>Debugger Console</code><dd><a name="index-GDB-Console-273"></a><a name="index-DBX-Console-274"></a><a name="index-Ladebug-Console-275"></a><a name="index-XDB-Console-276"></a><a name="index-JDB-Console-277"></a><a name="index-PYDB-Console-278"></a><a name="index-Perl-Console-279"></a><a name="index-Bash-Console-280"></a><a name="index-GNU-Make-Console-281"></a><a name="index-Alt_002b1-282"></a>Open the debugger console (<Alt+1>). See <a href="#Commands">Commands</a>, for details.
3620
3621
<br><dt><code>Source Window</code><dd><a name="index-Source-Window-283"></a><a name="index-Alt_002b2-284"></a>Open the source window (<Alt+2>). See <a href="#Navigating">Navigating</a>, for details.
3622
3623
<br><dt><code>Data Window</code><dd><a name="index-Data-Window-285"></a><a name="index-Alt_002b3-286"></a>Open the data window (<Alt+3>). See <a href="#Displaying-Values">Displaying Values</a>, for details.
3624
3625
<br><dt><code>Machine Code Window</code><dd><a name="index-Machine-Code-Window-287"></a><a name="index-Alt_002b4-288"></a>Show machine code (<Alt+4>). See <a href="#Machine-Code">Machine Code</a>, for details.
4092
3626
</dl>
4093
3627
4094
3628
<div class="node">
4095
3629
<p><hr>
4096
<small class=header>
4097
Node:<a name="Program%20Menu">Program Menu</a>,
4098
Next:<a rel="next" accesskey="n" href="#Commands%20Menu">Commands Menu</a>,
4099
Previous:<a rel="previous" accesskey="p" href="#View%20Menu">View Menu</a>,
4100
Up:<a rel="up" accesskey="u" href="#Menu%20Bar">Menu Bar</a>
3630
<a name="Program-Menu"></a>
3631
Next: <a rel="next" accesskey="n" href="#Commands-Menu">Commands Menu</a>,
3632
Previous: <a rel="previous" accesskey="p" href="#View-Menu">View Menu</a>,
3633
Up: <a rel="up" accesskey="u" href="#Menu-Bar">Menu Bar</a>
4101
3634
</small>
4102
3635
4103
<br>
3636
4104
3637
</div>
4105
3638
4106
<h4 class="subsection">The Program Menu</h4>
3639
<h4 class="subsection">3.1.4 The Program Menu</h4>
4107
3640
4108
<p>The <code>Program</code> menu performs operations related to the program being
3641
<p><a name="index-Program-289"></a>
3642
The ‘<samp><span class="samp">Program</span></samp>’ menu performs operations related to the program being
4109
3643
debugged, such as starting and stopping the program.
4110
3644
4111
3645
<p>Most of these operations are also found on the command tool
4112
(see <a href="#Command%20Tool">Command Tool</a>).
3646
(see <a href="#Command-Tool">Command Tool</a>).
4113
3647
4114
3648
<dl>
4115
<dt><code>Run</code>
4116
<dd>Start program execution, prompting for program arguments (<F2>).
4117
See <a href="#Starting%20Program%20Execution">Starting Program Execution</a>, for details.
4118
4119
<br><dt><code>Run Again</code>
4120
<dd>Start program execution with the most recently used arguments (<F3>).
4121
See <a href="#Starting%20Program%20Execution">Starting Program Execution</a>, for details.
4122
4123
<br><dt><code>Run in Execution Window</code>
4124
<dd>If enabled, start next program execution in separate execution window.
4125
See <a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>, for details.
4126
4127
<br><dt><code>Step</code>
4128
<dd>Continue running your program until control reaches a different source
4129
line, then stop it and return control to <small>DDD</small> (<F5>).
4130
See <a href="#Resuming%20Execution">Resuming Execution</a>, for details.
4131
4132
<br><dt><code>Step Instruction</code>
4133
<dd>Execute one machine instruction, then stop and return to <small>DDD</small>
4134
(<Shift+F5>). See <a href="#Machine%20Code%20Execution">Machine Code Execution</a>, for details.
4135
4136
<br><dt><code>Next</code>
4137
<dd>Continue to the next source line in the current (innermost) stack frame
4138
(<F6>). This is similar to <code>Step</code>, but function calls that
3649
<dt><code>Run</code><dd><a name="index-Run-290"></a><a name="index-F2-291"></a>Start program execution, prompting for program arguments (<F2>).
3650
See <a href="#Starting-Program-Execution">Starting Program Execution</a>, for details.
3651
3652
<br><dt><code>Run Again</code><dd><a name="index-Run-Again-292"></a><a name="index-F3-293"></a>Start program execution with the most recently used arguments (<F3>).
3653
See <a href="#Starting-Program-Execution">Starting Program Execution</a>, for details.
3654
3655
<br><dt><code>Run in Execution Window</code><dd><a name="index-Run-in-Execution-Window-294"></a>If enabled, start next program execution in separate execution window.
3656
See <a href="#Using-the-Execution-Window">Using the Execution Window</a>, for details.
3657
3658
<br><dt><code>Step</code><dd><a name="index-Step-295"></a><a name="index-F5-296"></a>Continue running your program until control reaches a different source
3659
line, then stop it and return control to <acronym>DDD</acronym> (<F5>).
3660
See <a href="#Resuming-Execution">Resuming Execution</a>, for details.
3661
3662
<br><dt><code>Step Instruction</code><dd><a name="index-Step-Instruction-297"></a><a name="index-Shift_002bF5-298"></a>Execute one machine instruction, then stop and return to <acronym>DDD</acronym>
3663
(<Shift+F5>). See <a href="#Machine-Code-Execution">Machine Code Execution</a>, for details.
3664
3665
<br><dt><code>Next</code><dd><a name="index-Next-299"></a><a name="index-F6-300"></a>Continue to the next source line in the current (innermost) stack frame
3666
(<F6>). This is similar to ‘<samp><span class="samp">Step</span></samp>’, but function calls that
4139
3667
appear within the line of code are executed without stopping.
4140
See <a href="#Resuming%20Execution">Resuming Execution</a>, for details.
3668
See <a href="#Resuming-Execution">Resuming Execution</a>, for details.
4141
3669
4142
<br><dt><code>Next Instruction</code>
4143
<dd>Execute one machine instruction, but if it is a function call,
3670
<br><dt><code>Next Instruction</code><dd><a name="index-Next-Instruction-301"></a><a name="index-Shift_002bF6-302"></a>Execute one machine instruction, but if it is a function call,
4144
3671
proceed until the function returns (<Shift+F6>).
4145
See <a href="#Machine%20Code%20Execution">Machine Code Execution</a>, for details.
3672
See <a href="#Machine-Code-Execution">Machine Code Execution</a>, for details.
4146
3673
4147
<br><dt><code>Until</code>
4148
<dd>Continue running until a source line past the current line, in the
4149
current stack frame, is reached (<F7>). See <a href="#Resuming%20Execution">Resuming Execution</a>,
3674
<br><dt><code>Until</code><dd><a name="index-Until-303"></a><a name="index-F7-304"></a>Continue running until a source line past the current line, in the
3675
current stack frame, is reached (<F7>). See <a href="#Resuming-Execution">Resuming Execution</a>,
4150
3676
for details.
4151
3677
4152
<br><dt><code>Finish</code>
4153
<dd>Continue running until just after function in the selected stack frame
4154
returns (<F8>). Print the returned value (if any). See <a href="#Resuming%20Execution">Resuming Execution</a>, for details.
3678
<br><dt><code>Finish</code><dd><a name="index-Finish-305"></a><a name="index-F8-306"></a>Continue running until just after function in the selected stack frame
3679
returns (<F8>). Print the returned value (if any). See <a href="#Resuming-Execution">Resuming Execution</a>, for details.
4155
3680
4156
<br><dt><code>Continue</code>
4157
<dd>Resume program execution, at the address where your program last stopped
3681
<br><dt><code>Continue</code><dd><a name="index-Continue-307"></a><a name="index-F9-308"></a>Resume program execution, at the address where your program last stopped
4158
3682
(<F9>); any breakpoints set at that address are bypassed.
4159
See <a href="#Resuming%20Execution">Resuming Execution</a>, for details.
3683
See <a href="#Resuming-Execution">Resuming Execution</a>, for details.
4160
3684
4161
<br><dt><code>Continue Without Signal</code>
4162
<dd>Continue execution without giving a signal (<Shift+F9>). This is
3685
<br><dt><code>Continue Without Signal</code><dd><a name="index-Continue-Without-Signal-309"></a><a name="index-Shift_002bF9-310"></a>Continue execution without giving a signal (<Shift+F9>). This is
4163
3686
useful when your program stopped on account of a signal and would
4164
ordinary see the signal when resumed with <code>Continue</code>.
3687
ordinary see the signal when resumed with ‘<samp><span class="samp">Continue</span></samp>’.
4165
3688
See <a href="#Signals">Signals</a>, for details.
4166
3689
4167
<br><dt><code>Kill</code>
4168
<dd>Kill the process of the debugged program (<F4>). See <a href="#Killing%20the%20Program">Killing the Program</a>, for details.
3690
<br><dt><code>Kill</code><dd><a name="index-Kill-311"></a><a name="index-F4-312"></a>Kill the process of the debugged program (<F4>). See <a href="#Killing-the-Program">Killing the Program</a>, for details.
4169
3691
4170
<br><dt><code>Interrupt</code>
4171
<dd>Interrupt program execution (<Esc> or <Ctrl+C>;
4172
see <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>, for details). This is equivalent to
3692
<br><dt><code>Interrupt</code><dd><a name="index-Interrupt-313"></a><a name="index-Esc-314"></a><a name="index-Ctrl_002bC-315"></a>Interrupt program execution (<Esc> or <Ctrl+C>;
3693
see <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a>, for details). This is equivalent to
4173
3694
sending an interrupt signal to the process. See <a href="#Interrupting">Interrupting</a>, for
4174
3695
details.
4175
3696
4176
<br><dt><code>Abort</code>
4177
<dd>Abort program execution (and maybe debugger execution, too;
3697
<br><dt><code>Abort</code><dd><a name="index-Abort-316"></a><a name="index-Aborting-execution-317"></a><a name="index-Execution_002c-aborting-318"></a><a name="index-SIGABRT-signal-319"></a><a name="index-Ctrl_002b_005c-320"></a>Abort program execution (and maybe debugger execution, too;
4178
3698
<Ctrl+\>). This is equivalent to sending a <code>SIGABRT</code> signal to
4179
3699
the process. See <a href="#Quitting">Quitting</a>, for details.
4180
3700
</dl>
4181
3701
4182
3702
<div class="node">
4183
3703
<p><hr>
4184
<small class=header>
4185
Node:<a name="Commands%20Menu">Commands Menu</a>,
4186
Next:<a rel="next" accesskey="n" href="#Status%20Menu">Status Menu</a>,
4187
Previous:<a rel="previous" accesskey="p" href="#Program%20Menu">Program Menu</a>,
4188
Up:<a rel="up" accesskey="u" href="#Menu%20Bar">Menu Bar</a>
3704
<a name="Commands-Menu"></a>
3705
Next: <a rel="next" accesskey="n" href="#Status-Menu">Status Menu</a>,
3706
Previous: <a rel="previous" accesskey="p" href="#Program-Menu">Program Menu</a>,
3707
Up: <a rel="up" accesskey="u" href="#Menu-Bar">Menu Bar</a>
4189
3708
</small>
4190
3709
4191
<br>
3710
4192
3711
</div>
4193
3712
4194
<h4 class="subsection">The Commands Menu</h4>
3713
<h4 class="subsection">3.1.5 The Commands Menu</h4>
4195
3714
4196
<p>The <code>Commands</code> menu performs operations related to <small>DDD</small>
3715
<p><a name="index-Commands-321"></a>
3716
The ‘<samp><span class="samp">Commands</span></samp>’ menu performs operations related to <acronym>DDD</acronym>
4197
3717
commands, such as accessing the command history or defining new
4198
3718
commands.
4199
3719
4202
3722
commands.
4203
3723
4204
3724
<dl>
4205
<dt><code>Command History</code>
4206
<dd>View the command history. See <a href="#Command%20History">Command History</a>, for details.
4207
4208
<br><dt><code>Previous</code>
4209
<dd>Show the previous command from the command history (<Up>).
4210
See <a href="#Command%20History">Command History</a>, for details.
4211
4212
<br><dt><code>Next</code>
4213
<dd>Show the next command from the command history (<Down>).
4214
See <a href="#Command%20History">Command History</a>, for details.
4215
4216
<br><dt><code>Find Backward</code>
4217
<dd>Do an incremental search backward through the command history
4218
(<Ctrl+B>). See <a href="#Command%20History">Command History</a>, for details.
4219
4220
<br><dt><code>Find Forward</code>
4221
<dd>Do an incremental search forward through the command history (<Ctrl+F>).
4222
See <a href="#Command%20History">Command History</a>, for details.
4223
4224
<br><dt><code>Quit Search</code>
4225
<dd>Quit incremental search through the command history (<Esc>).
4226
See <a href="#Command%20History">Command History</a>, for details.
4227
4228
<br><dt><code>Complete</code>
4229
<dd>Complete the current command in the debugger console (<Tab>).
4230
See <a href="#Entering%20Commands">Entering Commands</a>, for details.
4231
4232
<br><dt><code>Apply</code>
4233
<dd>Apply the current command in the debugger console (<Apply>).
4234
See <a href="#Entering%20Commands">Entering Commands</a>, for details.
4235
4236
<br><dt><code>Clear Line</code>
4237
<dd>Clear the current command line in the debugger console (<Ctrl+U>).
4238
See <a href="#Entering%20Commands">Entering Commands</a>, for details.
4239
4240
<br><dt><code>Clear Window</code>
4241
<dd>Clear the debugger console (<Shift+Ctrl+U>). See <a href="#Entering%20Commands">Entering Commands</a>, for details.
4242
4243
<br><dt><code>Define Command</code>
4244
<dd>Define a new debugger command. See <a href="#Defining%20Commands">Defining Commands</a>, for details.
4245
4246
<br><dt><code>Edit Buttons</code>
4247
<dd>Customize <small>DDD</small> buttons. See <a href="#Defining%20Buttons">Defining Buttons</a>, for details.
3725
<dt><code>Command History</code><dd><a name="index-Command-History-322"></a>View the command history. See <a href="#Command-History">Command History</a>, for details.
3726
3727
<br><dt><code>Previous</code><dd><a name="index-Previous-323"></a><a name="index-Up-324"></a>Show the previous command from the command history (<Up>).
3728
See <a href="#Command-History">Command History</a>, for details.
3729
3730
<br><dt><code>Next</code><dd><a name="index-Next-325"></a><a name="index-Down-326"></a>Show the next command from the command history (<Down>).
3731
See <a href="#Command-History">Command History</a>, for details.
3732
3733
<br><dt><code>Find Backward</code><dd><a name="index-Find-Backward-327"></a><a name="index-Ctrl_002bB-328"></a>Do an incremental search backward through the command history
3734
(<Ctrl+B>). See <a href="#Command-History">Command History</a>, for details.
3735
3736
<br><dt><code>Find Forward</code><dd><a name="index-Find-Forward-329"></a><a name="index-Ctrl_002bF-330"></a>Do an incremental search forward through the command history (<Ctrl+F>).
3737
See <a href="#Command-History">Command History</a>, for details.
3738
3739
<br><dt><code>Quit Search</code><dd><a name="index-Quit-Search-331"></a><a name="index-Esc-332"></a>Quit incremental search through the command history (<Esc>).
3740
See <a href="#Command-History">Command History</a>, for details.
3741
3742
<br><dt><code>Complete</code><dd><a name="index-Complete-333"></a><a name="index-Tab-334"></a>Complete the current command in the debugger console (<Tab>).
3743
See <a href="#Entering-Commands">Entering Commands</a>, for details.
3744
3745
<br><dt><code>Apply</code><dd><a name="index-Apply-335"></a><a name="index-Return-336"></a>Apply the current command in the debugger console (<Apply>).
3746
See <a href="#Entering-Commands">Entering Commands</a>, for details.
3747
3748
<br><dt><code>Clear Line</code><dd><a name="index-Clear-Line-337"></a><a name="index-Ctrl_002bU-338"></a>Clear the current command line in the debugger console (<Ctrl+U>).
3749
See <a href="#Entering-Commands">Entering Commands</a>, for details.
3750
3751
<br><dt><code>Clear Window</code><dd><a name="index-Clear-Window-339"></a><a name="index-Shift_002bCtrl_002bU-340"></a>Clear the debugger console (<Shift+Ctrl+U>). See <a href="#Entering-Commands">Entering Commands</a>, for details.
3752
3753
<br><dt><code>Define Command</code><dd><a name="index-Define-Command-341"></a>Define a new debugger command. See <a href="#Defining-Commands">Defining Commands</a>, for details.
3754
3755
<br><dt><code>Edit Buttons</code><dd><a name="index-Edit-Buttons-342"></a>Customize <acronym>DDD</acronym> buttons. See <a href="#Defining-Buttons">Defining Buttons</a>, for details.
4248
3756
</dl>
4249
3757
4250
3758
<div class="node">
4251
3759
<p><hr>
4252
<small class=header>
4253
Node:<a name="Status%20Menu">Status Menu</a>,
4254
Next:<a rel="next" accesskey="n" href="#Source%20Menu">Source Menu</a>,
4255
Previous:<a rel="previous" accesskey="p" href="#Commands%20Menu">Commands Menu</a>,
4256
Up:<a rel="up" accesskey="u" href="#Menu%20Bar">Menu Bar</a>
3760
<a name="Status-Menu"></a>
3761
Next: <a rel="next" accesskey="n" href="#Source-Menu">Source Menu</a>,
3762
Previous: <a rel="previous" accesskey="p" href="#Commands-Menu">Commands Menu</a>,
3763
Up: <a rel="up" accesskey="u" href="#Menu-Bar">Menu Bar</a>
4257
3764
</small>
4258
3765
4259
<br>
3766
4260
3767
</div>
4261
3768
4262
<h4 class="subsection">The Status Menu</h4>
3769
<h4 class="subsection">3.1.6 The Status Menu</h4>
4263
3770
4264
<p>The <code>Status</code> menu lets you examine the program status, such as the
3771
<p><a name="index-Status-343"></a>
3772
The ‘<samp><span class="samp">Status</span></samp>’ menu lets you examine the program status, such as the
4265
3773
stack traces, registers, or threads.
4266
3774
4267
3775
<dl>
4268
<dt><code>Backtrace</code>
4269
<dd>View the current backtrace. See <a href="#Backtraces">Backtraces</a>, for a discussion.
4270
4271
<br><dt><code>Registers</code>
4272
<dd>View the current register contents. See <a href="#Registers">Registers</a>, for details.
4273
4274
<br><dt><code>Threads</code>
4275
<dd>View the current threads. See <a href="#Threads">Threads</a>, for details.
4276
4277
<br><dt><code>Signals</code>
4278
<dd>View and edit the current signal handling. See <a href="#Signals">Signals</a>, for details.
4279
4280
<br><dt><code>Up</code>
4281
<dd>Select the stack frame (i.e. the function) that called this one
3776
<dt><code>Backtrace</code><dd><a name="index-Backtrace-344"></a>View the current backtrace. See <a href="#Backtraces">Backtraces</a>, for a discussion.
3777
3778
<br><dt><code>Registers</code><dd><a name="index-Registers-345"></a>View the current register contents. See <a href="#Registers">Registers</a>, for details.
3779
3780
<br><dt><code>Threads</code><dd><a name="index-Threads-346"></a>View the current threads. See <a href="#Threads">Threads</a>, for details.
3781
3782
<br><dt><code>Signals</code><dd><a name="index-Signals-347"></a>View and edit the current signal handling. See <a href="#Signals">Signals</a>, for details.
3783
3784
<br><dt><code>Up</code><dd><a name="index-Up-348"></a><a name="index-Ctrl_002bUp-349"></a>Select the stack frame (i.e. the function) that called this one
4282
3785
(<Ctrl+Up>). This advances toward the outermost frame, to higher
4283
3786
frame numbers, to frames that have existed longer. See <a href="#Stack">Stack</a>, for
4284
3787
details.
4285
3788
4286
<br><dt><code>Down</code>
4287
<dd>Select the stack frame (i.e. the function) that was called by this one
3789
<br><dt><code>Down</code><dd><a name="index-Down-350"></a><a name="index-Ctrl_002bDown-351"></a>Select the stack frame (i.e. the function) that was called by this one
4288
3790
(<Ctrl+Down>). This advances toward the innermost frame, to lower
4289
3791
frame numbers, to frames that were created more recently. See <a href="#Stack">Stack</a>,
4290
3792
for details.
4292
3794
4293
3795
<div class="node">
4294
3796
<p><hr>
4295
<small class=header>
4296
Node:<a name="Source%20Menu">Source Menu</a>,
4297
Next:<a rel="next" accesskey="n" href="#Data%20Menu">Data Menu</a>,
4298
Previous:<a rel="previous" accesskey="p" href="#Status%20Menu">Status Menu</a>,
4299
Up:<a rel="up" accesskey="u" href="#Menu%20Bar">Menu Bar</a>
3797
<a name="Source-Menu"></a>
3798
Next: <a rel="next" accesskey="n" href="#Data-Menu">Data Menu</a>,
3799
Previous: <a rel="previous" accesskey="p" href="#Status-Menu">Status Menu</a>,
3800
Up: <a rel="up" accesskey="u" href="#Menu-Bar">Menu Bar</a>
4300
3801
</small>
4301
3802
4302
<br>
3803
4303
3804
</div>
4304
3805
4305
<h4 class="subsection">The Source Menu</h4>
3806
<h4 class="subsection">3.1.7 The Source Menu</h4>
4306
3807
4307
<p>The <code>Source</code> menu performs source-related operations such as
3808
<p><a name="index-Source-352"></a>
3809
The ‘<samp><span class="samp">Source</span></samp>’ menu performs source-related operations such as
4308
3810
looking up items or editing breakpoints.
4309
3811
4310
3812
<dl>
4311
<dt><code>Breakpoints</code>
4312
<dd>Edit all Breakpoints. See <a href="#Editing%20all%20Breakpoints">Editing all Breakpoints</a>, for details.
4313
4314
<br><dt><code>Lookup ()</code>
4315
<dd>Look up the argument <code>()</code> in the source code (<Ctrl+/>).
4316
See <a href="#Looking%20up%20Definitions">Looking up Definitions</a>, for details.
4317
4318
<br><dt><code>Find >> ()</code>
4319
<dd>Look up the next occurrence of the argument <code>()</code> in the current
4320
source code (<Ctrl+.>). See <a href="#Textual%20Search">Textual Search</a>, for details.
4321
4322
<br><dt><code>Find << ()</code>
4323
<dd>Look up the previous occurrence of the argument <code>()</code> in the current
4324
source code (<Ctrl+,>). See <a href="#Textual%20Search">Textual Search</a>, for details.
4325
4326
<br><dt><code>Find Words Only</code>
4327
<dd>If enabled, find only complete words (<Alt+W>). See <a href="#Textual%20Search">Textual Search</a>, for details.
4328
4329
<br><dt><code>Find Case Sensitive</code>
4330
<dd>If enabled, find is case-sensitive (<Alt+I>). See <a href="#Textual%20Search">Textual Search</a>, for details.
4331
4332
<br><dt><code>Display Line Numbers</code>
4333
<dd>If enabled, prefix source lines with their line number (<Alt+N>).
4334
See <a href="#Customizing%20Source">Customizing Source</a>, for details.
4335
4336
<br><dt><code>Display Machine Code</code>
4337
<dd>If enabled, show machine code (<Alt+4>). See <a href="#Machine%20Code">Machine Code</a>, for details.
4338
4339
<br><dt><code>Edit Source</code>
4340
<dd>Invoke an editor for the current source file (<Shift+Ctrl+V>).
4341
See <a href="#Editing%20Source%20Code">Editing Source Code</a>, for details.
4342
4343
<br><dt><code>Reload Source</code>
4344
<dd>Reload the current source file (<Shift+Ctrl+L>). See <a href="#Editing%20Source%20Code">Editing Source Code</a>, for details.
3813
<dt><code>Breakpoints</code><dd><a name="index-Breakpoints-353"></a>Edit all Breakpoints. See <a href="#Editing-all-Breakpoints">Editing all Breakpoints</a>, for details.
3814
3815
<br><dt><code>Lookup ()</code><dd><a name="index-Lookup-_0028_0029-354"></a><a name="index-Ctrl_002b_002f-355"></a>Look up the argument ‘<samp><span class="samp">()</span></samp>’ in the source code (<Ctrl+/>).
3816
See <a href="#Looking-up-Definitions">Looking up Definitions</a>, for details.
3817
3818
<br><dt><code>Find >> ()</code><dd><a name="index-Find-_003e_003e-_0028_0029-356"></a><a name="index-Ctrl_002b_002e-357"></a>Look up the next occurrence of the argument ‘<samp><span class="samp">()</span></samp>’ in the current
3819
source code (<Ctrl+.>). See <a href="#Textual-Search">Textual Search</a>, for details.
3820
3821
<br><dt><code>Find << ()</code><dd><a name="index-Find-_003c_003c-_0028_0029-358"></a><a name="index-Ctrl_002b_002c-359"></a>Look up the previous occurrence of the argument ‘<samp><span class="samp">()</span></samp>’ in the current
3822
source code (<Ctrl+,>). See <a href="#Textual-Search">Textual Search</a>, for details.
3823
3824
<br><dt><code>Find Words Only</code><dd><a name="index-Find-Words-Only-360"></a><a name="index-Alt_002bW-361"></a>If enabled, find only complete words (<Alt+W>). See <a href="#Textual-Search">Textual Search</a>, for details.
3825
3826
<br><dt><code>Find Case Sensitive</code><dd><a name="index-Find-Case-Sensitive-362"></a><a name="index-Alt_002bI-363"></a>If enabled, find is case-sensitive (<Alt+I>). See <a href="#Textual-Search">Textual Search</a>, for details.
3827
3828
<br><dt><code>Display Line Numbers</code><dd><a name="index-Display-Line-Numbers-364"></a><a name="index-Alt_002bN-365"></a>If enabled, prefix source lines with their line number (<Alt+N>).
3829
See <a href="#Customizing-Source">Customizing Source</a>, for details.
3830
3831
<br><dt><code>Display Machine Code</code><dd><a name="index-Display-Machine-Code-366"></a><a name="index-Alt_002b4-367"></a>If enabled, show machine code (<Alt+4>). See <a href="#Machine-Code">Machine Code</a>, for details.
3832
3833
<br><dt><code>Edit Source</code><dd><a name="index-Edit-Source-368"></a><a name="index-Shift_002bCtrl_002bV-369"></a>Invoke an editor for the current source file (<Shift+Ctrl+V>).
3834
See <a href="#Editing-Source-Code">Editing Source Code</a>, for details.
3835
3836
<br><dt><code>Reload Source</code><dd><a name="index-Reload-Source-370"></a><a name="index-Shift_002bCtrl_002bL-371"></a>Reload the current source file (<Shift+Ctrl+L>). See <a href="#Editing-Source-Code">Editing Source Code</a>, for details.
4345
3837
</dl>
4346
3838
4347
3839
<div class="node">
4348
3840
<p><hr>
4349
<small class=header>
4350
Node:<a name="Data%20Menu">Data Menu</a>,
4351
Next:<a rel="next" accesskey="n" href="#Maintenance%20Menu">Maintenance Menu</a>,
4352
Previous:<a rel="previous" accesskey="p" href="#Source%20Menu">Source Menu</a>,
4353
Up:<a rel="up" accesskey="u" href="#Menu%20Bar">Menu Bar</a>
3841
<a name="Data-Menu"></a>
3842
Next: <a rel="next" accesskey="n" href="#Maintenance-Menu">Maintenance Menu</a>,
3843
Previous: <a rel="previous" accesskey="p" href="#Source-Menu">Source Menu</a>,
3844
Up: <a rel="up" accesskey="u" href="#Menu-Bar">Menu Bar</a>
4354
3845
</small>
4355
3846
4356
<br>
3847
4357
3848
</div>
4358
3849
4359
<h4 class="subsection">The Data Menu</h4>
3850
<h4 class="subsection">3.1.8 The Data Menu</h4>
4360
3851
4361
<p>The <code>Data</code> menu performs data-related operations such as editing
3852
<p><a name="index-Data-372"></a>
3853
The ‘<samp><span class="samp">Data</span></samp>’ menu performs data-related operations such as editing
4362
3854
displays or layouting the display graph.
4363
3855
4364
3856
<dl>
4365
<dt><code>Displays</code>
4366
<dd>Invoke the Display Editor. See <a href="#Editing%20all%20Displays">Editing all Displays</a>, for details.
4367
4368
<br><dt><code>Watchpoints</code>
4369
<dd>Edit all Watchpoints. See <a href="#Editing%20all%20Watchpoints">Editing all Watchpoints</a>, for details.
4370
4371
<br><dt><code>Memory</code>
4372
<dd>View a memory dump. See <a href="#Examining%20Memory">Examining Memory</a>, for details.
4373
4374
<br><dt><code>Print ()</code>
4375
<dd>Print the value of <code>()</code> in the debugger console (<Ctrl+=>).
4376
See <a href="#Printing%20Values">Printing Values</a>, for details.
4377
4378
<br><dt><code>Display ()</code>
4379
<dd>Display the value of <code>()</code> in the data window (<Ctrl+->).
4380
See <a href="#Displaying%20Values">Displaying Values</a>, for details.
4381
4382
<br><dt><code>Detect Aliases</code>
4383
<dd>If enabled, detect shared data structures (<Alt+A>). See <a href="#Shared%20Structures">Shared Structures</a>, for a discussion.
4384
4385
<br><dt><code>Display Local Variables</code>
4386
<dd>Show all local variables in a display (<Alt+L>). See <a href="#Displaying%20Local%20Variables">Displaying Local Variables</a>, for details.
4387
4388
<br><dt><code>Display Arguments</code>
4389
<dd>Show all arguments of the current function in a display (<Alt+U>).
4390
See <a href="#Displaying%20Local%20Variables">Displaying Local Variables</a>, for details.
4391
4392
<br><dt><code>Status Displays</code>
4393
<dd>Show current debugging information in a display. See <a href="#Displaying%20Program%20Status">Displaying Program Status</a>, for details.
4394
4395
<br><dt><code>Align on Grid</code>
4396
<dd>Align all displays on the grid (<Alt+G>). See <a href="#Aligning%20Displays">Aligning Displays</a>, for a
3857
<dt><code>Displays</code><dd><a name="index-Displays-373"></a>Invoke the Display Editor. See <a href="#Editing-all-Displays">Editing all Displays</a>, for details.
3858
3859
<br><dt><code>Watchpoints</code><dd><a name="index-Watchpoints-374"></a>Edit all Watchpoints. See <a href="#Editing-all-Watchpoints">Editing all Watchpoints</a>, for details.
3860
3861
<br><dt><code>Memory</code><dd><a name="index-Memory-375"></a>View a memory dump. See <a href="#Examining-Memory">Examining Memory</a>, for details.
3862
3863
<br><dt><code>Print ()</code><dd><a name="index-Print-_0028_0029-376"></a><a name="index-Ctrl_002b_003d-377"></a>Print the value of ‘<samp><span class="samp">()</span></samp>’ in the debugger console (<Ctrl+=>).
3864
See <a href="#Printing-Values">Printing Values</a>, for details.
3865
3866
<br><dt><code>Display ()</code><dd><a name="index-Display-_0028_0029-378"></a><a name="index-Ctrl_002b_002d-379"></a>Display the value of ‘<samp><span class="samp">()</span></samp>’ in the data window (<Ctrl+->).
3867
See <a href="#Displaying-Values">Displaying Values</a>, for details.
3868
3869
<br><dt><code>Detect Aliases</code><dd><a name="index-Detect-Aliases-380"></a><a name="index-Alt_002bA-381"></a>If enabled, detect shared data structures (<Alt+A>). See <a href="#Shared-Structures">Shared Structures</a>, for a discussion.
3870
3871
<br><dt><code>Display Local Variables</code><dd><a name="index-Display-Local-Variables-382"></a><a name="index-Alt_002bL-383"></a>Show all local variables in a display (<Alt+L>). See <a href="#Displaying-Local-Variables">Displaying Local Variables</a>, for details.
3872
3873
<br><dt><code>Display Arguments</code><dd><a name="index-Display-Arguments-384"></a><a name="index-Alt_002bU-385"></a>Show all arguments of the current function in a display (<Alt+U>).
3874
See <a href="#Displaying-Local-Variables">Displaying Local Variables</a>, for details.
3875
3876
<br><dt><code>Status Displays</code><dd><a name="index-Status-Displays-386"></a>Show current debugging information in a display. See <a href="#Displaying-Program-Status">Displaying Program Status</a>, for details.
3877
3878
<br><dt><code>Align on Grid</code><dd><a name="index-Align-on-Grid-387"></a><a name="index-Alt_002bG-388"></a>Align all displays on the grid (<Alt+G>). See <a href="#Aligning-Displays">Aligning Displays</a>, for a
4397
3879
discussion.
4398
3880
4399
<br><dt><code>Rotate Graph</code>
4400
<dd>Rotate the graph by 90 degrees (<Alt+R>). See <a href="#Rotating%20the%20Graph">Rotating the Graph</a>, for details.
4401
4402
<br><dt><code>Layout Graph</code>
4403
<dd>Layout the graph (<Alt+Y>). See <a href="#Layouting%20the%20Graph">Layouting the Graph</a>, for details.
4404
4405
<br><dt><code>Refresh</code>
4406
<dd>Update all values in the data window (<Ctrl+L>). See <a href="#Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>, for details.
3881
<br><dt><code>Rotate Graph</code><dd><a name="index-Rotate-Graph-389"></a><a name="index-Alt_002bR-390"></a>Rotate the graph by 90 degrees (<Alt+R>). See <a href="#Rotating-the-Graph">Rotating the Graph</a>, for details.
3882
3883
<br><dt><code>Layout Graph</code><dd><a name="index-Layout-Graph-391"></a><a name="index-Alt_002bY-392"></a>Layout the graph (<Alt+Y>). See <a href="#Layouting-the-Graph">Layouting the Graph</a>, for details.
3884
3885
<br><dt><code>Refresh</code><dd><a name="index-Refresh-393"></a><a name="index-Ctrl_002bL-394"></a>Update all values in the data window (<Ctrl+L>). See <a href="#Refreshing-the-Data-Window">Refreshing the Data Window</a>, for details.
4407
3886
</dl>
4408
3887
4409
3888
<div class="node">
4410
3889
<p><hr>
4411
<small class=header>
4412
Node:<a name="Maintenance%20Menu">Maintenance Menu</a>,
4413
Next:<a rel="next" accesskey="n" href="#Help%20Menu">Help Menu</a>,
4414
Previous:<a rel="previous" accesskey="p" href="#Data%20Menu">Data Menu</a>,
4415
Up:<a rel="up" accesskey="u" href="#Menu%20Bar">Menu Bar</a>
3890
<a name="Maintenance-Menu"></a>
3891
Next: <a rel="next" accesskey="n" href="#Help-Menu">Help Menu</a>,
3892
Previous: <a rel="previous" accesskey="p" href="#Data-Menu">Data Menu</a>,
3893
Up: <a rel="up" accesskey="u" href="#Menu-Bar">Menu Bar</a>
4416
3894
</small>
4417
3895
4418
<br>
3896
4419
3897
</div>
4420
3898
4421
<h4 class="subsection">The Maintenance Menu</h4>
3899
<h4 class="subsection">3.1.9 The Maintenance Menu</h4>
4422
3900
4423
<p>The <code>Maintenance</code> menu performs operations that are useful for
4424
debugging <small>DDD</small>.
3901
<p><a name="index-Maintenance-395"></a>
3902
The ‘<samp><span class="samp">Maintenance</span></samp>’ menu performs operations that are useful for
3903
debugging <acronym>DDD</acronym>.
4425
3904
4426
3905
<p>By default, this menu is disabled; it is enabled by specifically
4427
requesting it at <small>DDD</small> invocation (via the <code>--maintenance</code>
4428
option; see <a href="#Options">Options</a>). It is also enabled when <small>DDD</small> gets a
3906
requesting it at <acronym>DDD</acronym> invocation (via the <samp><span class="option">--maintenance</span></samp>
3907
option; see <a href="#Options">Options</a>). It is also enabled when <acronym>DDD</acronym> gets a
4429
3908
fatal signal.
4430
3909
4431
3910
<dl>
4432
<dt><code>Debug </code><small>DDD</small><code></code>
4433
<dd>Invoke a debugger (typically, <small>GDB</small>) and attach it to this <small>DDD</small>
4434
process (<F12>). This is useful only if you are a <small>DDD</small> maintainer.
4435
4436
<br><dt><code>Dump Core Now</code>
4437
<dd>Make this <small>DDD</small> process dump core. This can also be achieved by
4438
sending <small>DDD</small> a <code>SIGUSR1</code> signal.
4439
4440
<br><dt><code>Tic Tac Toe</code>
4441
<dd>Invoke a Tic Tac Toe game. You must try to get three stop signs in a
4442
row, while preventing <small>DDD</small> from doing so with its skulls. Click
4443
on <code>New Game</code> to restart.
4444
4445
<br><dt><code>When </code><small>DDD</small><code> Crashes</code>
4446
<dd>Select what to do when <small>DDD</small> gets a fatal signal.
3911
<dt><code>Debug <acronym>DDD</acronym></code><dd><a name="index-F12-396"></a><a name="index-Debug-_0040value_007bDDD_007d-397"></a>Invoke a debugger (typically, <acronym>GDB</acronym>) and attach it to this <acronym>DDD</acronym>
3912
process (<F12>). This is useful only if you are a <acronym>DDD</acronym> maintainer.
3913
3914
<br><dt><code>Dump Core Now</code><dd><a name="index-Dump-Core-Now-398"></a><a name="index-SIGUSR1-signal-399"></a>Make this <acronym>DDD</acronym> process dump core. This can also be achieved by
3915
sending <acronym>DDD</acronym> a <code>SIGUSR1</code> signal.
3916
3917
<br><dt><code>Tic Tac Toe</code><dd><a name="index-Tic-Tac-Toe-400"></a><a name="index-Tic-Tac-Toe-game-401"></a><a name="index-New-Game-402"></a>Invoke a Tic Tac Toe game. You must try to get three stop signs in a
3918
row, while preventing <acronym>DDD</acronym> from doing so with its skulls. Click
3919
on ‘<samp><span class="samp">New Game</span></samp>’ to restart.
3920
3921
<br><dt><code>When <acronym>DDD</acronym> Crashes</code><dd><a name="index-When-_0040value_007bDDD_007d-Crashes-403"></a>Select what to do when <acronym>DDD</acronym> gets a fatal signal.
4447
3922
4448
3923
<dl>
4449
<dt><code>Debug </code><small>DDD</small><code></code>
4450
<dd>Invoke a debugger on the <small>DDD</small> core dump when <small>DDD</small>
4451
crashes. This is useful only if you are a <small>DDD</small> maintainer.
3924
<dt><code>Debug <acronym>DDD</acronym></code><dd><a name="index-Debug-_0040DDD_007b_007d-404"></a>Invoke a debugger on the <acronym>DDD</acronym> core dump when <acronym>DDD</acronym>
3925
crashes. This is useful only if you are a <acronym>DDD</acronym> maintainer.
4452
3926
4453
<br><dt><code>Dump Core</code>
4454
<dd>Just dump core when <small>DDD</small> crashes; don't invoke a debugger. This
3927
<br><dt><code>Dump Core</code><dd><a name="index-Dump-Core-405"></a>Just dump core when <acronym>DDD</acronym> crashes; don't invoke a debugger. This
4455
3928
is the default setting, as the core dump may contain important
4456
information required for debugging <small>DDD</small>.
3929
information required for debugging <acronym>DDD</acronym>.
4457
3930
4458
<br><dt><code>Do Nothing</code>
4459
<dd>Do not dump core or invoke a debugger when <small>DDD</small> crashes.
3931
<br><dt><code>Do Nothing</code><dd><a name="index-Do-Nothing-406"></a>Do not dump core or invoke a debugger when <acronym>DDD</acronym> crashes.
4460
3932
</dl>
4461
3933
4462
<br><dt><code>Remove Menu</code>
4463
<dd>Make this menu inaccessible again.
3934
<br><dt><code>Remove Menu</code><dd><a name="index-Remove-Menu-407"></a>Make this menu inaccessible again.
4464
3935
</dl>
4465
3936
4466
3937
<div class="node">
4467
3938
<p><hr>
4468
<small class=header>
4469
Node:<a name="Help%20Menu">Help Menu</a>,
4470
Next:<a rel="next" accesskey="n" href="#Customizing%20the%20Menu%20Bar">Customizing the Menu Bar</a>,
4471
Previous:<a rel="previous" accesskey="p" href="#Maintenance%20Menu">Maintenance Menu</a>,
4472
Up:<a rel="up" accesskey="u" href="#Menu%20Bar">Menu Bar</a>
3939
<a name="Help-Menu"></a>
3940
Next: <a rel="next" accesskey="n" href="#Customizing-the-Menu-Bar">Customizing the Menu Bar</a>,
3941
Previous: <a rel="previous" accesskey="p" href="#Maintenance-Menu">Maintenance Menu</a>,
3942
Up: <a rel="up" accesskey="u" href="#Menu-Bar">Menu Bar</a>
4473
3943
</small>
4474
3944
4475
<br>
3945
4476
3946
</div>
4477
3947
4478
<h4 class="subsection">The Help Menu</h4>
3948
<h4 class="subsection">3.1.10 The Help Menu</h4>
4479
3949
4480
<p>The <code>Help</code> menu gives help on <small>DDD</small> usage. See <a href="#Getting%20Help">Getting Help</a>, for a discussion on how to get help within <small>DDD</small>.
3950
<p><a name="index-Help-408"></a>
3951
The ‘<samp><span class="samp">Help</span></samp>’ menu gives help on <acronym>DDD</acronym> usage. See <a href="#Getting-Help">Getting Help</a>, for a discussion on how to get help within <acronym>DDD</acronym>.
4481
3952
4482
3953
<dl>
4483
<dt><code>Overview</code>
4484
<dd>Explains the most important concepts of <small>DDD</small> help.
4485
4486
<br><dt><code>On Item</code>
4487
<dd>Lets you click on an item to get help on it.
4488
4489
<br><dt><code>On Window</code>
4490
<dd>Gives you help on this <small>DDD</small> window.
4491
4492
<br><dt><code>What Now?</code>
4493
<dd>Gives a hint on what to do next.
4494
4495
<br><dt><code>Tip of the Day</code>
4496
<dd>Shows the current tip of the day.
4497
4498
<br><dt><code></code><small>DDD</small><code> Reference</code>
4499
<dd>Shows the <small>DDD</small> Manual.
4500
4501
<br><dt><code></code><small>DDD</small><code> News</code>
4502
<dd>Shows what's new in this <small>DDD</small> release.
4503
4504
<br><dt><code>Debugger Reference</code>
4505
<dd>Shows the on-line documentation for the inferior debugger.
4506
4507
<br><dt><code></code><small>DDD</small><code> License</code>
4508
<dd>Shows the <small>DDD</small> License (see <a href="#License">License</a>).
4509
4510
<br><dt><code></code><small>DDD</small><code> </code><small>WWW</small><code> Page</code>
4511
<dd>Invokes a <small>WWW</small> browser for the <small>DDD</small> <small>WWW</small> page.
4512
4513
<br><dt><code>About </code><small>DDD</small><code></code>
4514
<dd>Shows version and copyright information.
3954
<dt><code>Overview</code><dd><a name="index-Overview-409"></a>Explains the most important concepts of <acronym>DDD</acronym> help.
3955
3956
<br><dt><code>On Item</code><dd><a name="index-On-item-410"></a>Lets you click on an item to get help on it.
3957
3958
<br><dt><code>On Window</code><dd><a name="index-On-item-411"></a>Gives you help on this <acronym>DDD</acronym> window.
3959
3960
<br><dt><code>What Now?</code><dd><a name="index-What-Now_003f-412"></a>Gives a hint on what to do next.
3961
3962
<br><dt><code>Tip of the Day</code><dd><a name="index-Tip-of-the-Day-413"></a>Shows the current tip of the day.
3963
3964
<br><dt><code><acronym>DDD</acronym> Reference</code><dd><a name="index-g_t_0040value_007bDDD_007d-Reference-414"></a>Shows the <acronym>DDD</acronym> Manual.
3965
3966
<br><dt><code><acronym>DDD</acronym> News</code><dd><a name="index-g_t_0040value_007bDDD_007d-News-415"></a>Shows what's new in this <acronym>DDD</acronym> release.
3967
3968
<br><dt><code>Debugger Reference</code><dd><a name="index-Bash-Reference-416"></a><a name="index-DBX-Reference-417"></a><a name="index-Debugger-Reference-418"></a><a name="index-GDB-Reference-419"></a><a name="index-JDB-Reference-420"></a><a name="index-Ladebug-Reference-421"></a><a name="index-Perl-Reference-422"></a><a name="index-PYDB-Reference-423"></a><a name="index-XDB-Reference-424"></a>Shows the on-line documentation for the inferior debugger.
3969
3970
<br><dt><code><acronym>DDD</acronym> License</code><dd><a name="index-g_t_0040value_007bDDD_007d-License-425"></a>Shows the <acronym>DDD</acronym> License (see <a href="#License">License</a>).
3971
3972
<br><dt><code><acronym>DDD</acronym> <acronym>WWW</acronym> Page</code><dd><a name="index-g_t_0040value_007bDDD_007d-WWW-Page-426"></a>Invokes a <acronym>WWW</acronym> browser for the <acronym>DDD</acronym> <acronym>WWW</acronym> page.
3973
3974
<br><dt><code>About <acronym>DDD</acronym></code><dd><a name="index-About-_0040DDD_007b_007d-427"></a>Shows version and copyright information.
4515
3975
</dl>
4516
3976
4517
3977
<div class="node">
4518
3978
<p><hr>
4519
<small class=header>
4520
Node:<a name="Customizing%20the%20Menu%20Bar">Customizing the Menu Bar</a>,
4521
Previous:<a rel="previous" accesskey="p" href="#Help%20Menu">Help Menu</a>,
4522
Up:<a rel="up" accesskey="u" href="#Menu%20Bar">Menu Bar</a>
3979
<a name="Customizing-the-Menu-Bar"></a>
3980
Previous: <a rel="previous" accesskey="p" href="#Help-Menu">Help Menu</a>,
3981
Up: <a rel="up" accesskey="u" href="#Menu-Bar">Menu Bar</a>
4523
3982
</small>
4524
3983
4525
<br>
3984
4526
3985
</div>
4527
3986
4528
<h4 class="subsection">Customizing the Menu Bar</h4>
3987
<h4 class="subsection">3.1.11 Customizing the Menu Bar</h4>
4529
3988
4530
<p>The Menu Bar can be customized in various ways (see <a href="#Customizing">Customizing</a>).
3989
<p>The Menu Bar can be customized in various ways (see <a href="#Customizing">Customizing</a>).
4531
3990
4532
3991
<ul class="menu">
4533
<li><a accesskey="1" href="#Auto-Raise%20Menus">Auto-Raise Menus</a>:
4534
<li><a accesskey="2" href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>:
3992
<li><a accesskey="1" href="#Auto_002dRaise-Menus">Auto-Raise Menus</a>
3993
<li><a accesskey="2" href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a>
4535
3994
</ul>
4536
3995
4537
3996
<div class="node">
4538
3997
<p><hr>
4539
<small class=header>
4540
Node:<a name="Auto-Raise%20Menus">Auto-Raise Menus</a>,
4541
Next:<a rel="next" accesskey="n" href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>,
4542
Up:<a rel="up" accesskey="u" href="#Customizing%20the%20Menu%20Bar">Customizing the Menu Bar</a>
3998
<a name="Auto-Raise-Menus"></a>
3999
<a name="Auto_002dRaise-Menus"></a>
4000
Next: <a rel="next" accesskey="n" href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a>,
4001
Up: <a rel="up" accesskey="u" href="#Customizing-the-Menu-Bar">Customizing the Menu Bar</a>
4543
4002
</small>
4544
4003
4545
<br>
4004
4546
4005
</div>
4547
4006
4548
<h5 class="subsubsection">Auto-Raise Menus</h5>
4549
4550
<p>You can cause pull-down menus to be raised automatically.
4551
4552
<p>
4553
<table width="100%">
4554
<tr>
4555
<td align="left"><b>autoRaiseMenu</b><i> </i>(<i>class AutoRaiseMenu</i>)<i>
4556
</i></td>
4557
<td align="right">Resource</td>
4558
</tr>
4559
</table>
4560
<table width="95%" align="center">
4561
<tr><td>
4562
If <code>on</code> (default), <small>DDD</small> will always keep the pull down menu
4563
on top of the <small>DDD</small> main window. If this setting interferes with
4007
<h5 class="subsubsection">3.1.11.1 Auto-Raise Menus</h5>
4008
4009
<p>You can cause pull-down menus to be raised automatically.
4010
4011
<div class="defun">
4012
— Resource: <b>autoRaiseMenu</b> (<var>class AutoRaiseMenu</var>)<var><a name="index-autoRaiseMenu-428"></a></var><br>
4013
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), <acronym>DDD</acronym> will always keep the pull down menu
4014
on top of the <acronym>DDD</acronym> main window. If this setting interferes with
4564
4015
your window manager, or if your window manager does not auto-raise
4565
windows, set this resource to <code>off</code>.
4566
</td></tr>
4567
</table>
4016
windows, set this resource to ‘<samp><span class="samp">off</span></samp>’.
4017
</p></blockquote></div>
4568
4018
4569
<p>
4570
<table width="100%">
4571
<tr>
4572
<td align="left"><b>autoRaiseMenuDelay</b><i> </i>(<i>class AutoRaiseMenuDelay</i>)<i>
4573
</i></td>
4574
<td align="right">Resource</td>
4575
</tr>
4576
</table>
4577
<table width="95%" align="center">
4578
<tr><td>
4579
The time (in ms) during which an initial auto-raised window blocks
4019
<div class="defun">
4020
— Resource: <b>autoRaiseMenuDelay</b> (<var>class AutoRaiseMenuDelay</var>)<var><a name="index-autoRaiseMenuDelay-429"></a></var><br>
4021
<blockquote><p>The time (in ms) during which an initial auto-raised window blocks
4580
4022
further auto-raises. This is done to prevent two overlapping
4581
4023
auto-raised windows from entering an <em>auto-raise loop</em>. Default is
4582
4024
<code>100</code>.
4583
</td></tr>
4584
</table>
4025
</p></blockquote></div>
4585
4026
4586
4027
<div class="node">
4587
4028
<p><hr>
4588
<small class=header>
4589
Node:<a name="Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>,
4590
Previous:<a rel="previous" accesskey="p" href="#Auto-Raise%20Menus">Auto-Raise Menus</a>,
4591
Up:<a rel="up" accesskey="u" href="#Customizing%20the%20Menu%20Bar">Customizing the Menu Bar</a>
4029
<a name="Customizing-the-Edit-Menu"></a>
4030
Previous: <a rel="previous" accesskey="p" href="#Auto_002dRaise-Menus">Auto-Raise Menus</a>,
4031
Up: <a rel="up" accesskey="u" href="#Customizing-the-Menu-Bar">Customizing the Menu Bar</a>
4592
4032
</small>
4593
4033
4594
<br>
4034
4595
4035
</div>
4596
4036
4597
<h5 class="subsubsection">Customizing the Edit Menu</h5>
4037
<h5 class="subsubsection">3.1.11.2 Customizing the Edit Menu</h5>
4598
4038
4599
<p>In the Menu Bar, the <code>Edit</code> Menu can be customized in various ways.
4600
Use <code>Edit => Preferences => Startup</code> to customize
4039
<p>In the Menu Bar, the ‘<samp><span class="samp">Edit</span></samp>’ Menu can be customized in various ways.
4040
Use ‘<samp><span class="samp">Edit Preferences Startup</span></samp>’ to customize
4601
4041
these keys.
4602
4042
4603
<p>The <Ctrl+C> key can be bound to different actions, each in
4043
<p><a name="index-Ctrl_002bC-430"></a><a name="index-Ctrl_002bC-is-431"></a>The <Ctrl+C> key can be bound to different actions, each in
4604
4044
accordance with a specific style guide.
4605
4045
4606
4046
<dl>
4607
<dt><code>Copy</code>
4608
<dd>This setting binds <Ctrl+C> to the Copy operation, as specified by
4047
<dt><code>Copy</code><dd><a name="index-ESC-432"></a>This setting binds <Ctrl+C> to the Copy operation, as specified by
4609
4048
the KDE style guide. In this setting, use <ESC> to interrupt the
4610
4049
debuggee.
4611
4050
4612
<br><dt><code>Interrupt</code>
4613
<dd></dl>
4051
<br><dt><code>Interrupt</code><dd><a name="index-Ctrl_002bC-433"></a></dl>
4614
4052
This (default) setting binds <Ctrl+C> to the Interrupt operation, as
4615
used in several <small>UNIX</small> command-line programs. In this setting, use
4053
used in several <acronym>UNIX</acronym> command-line programs. In this setting, use
4616
4054
<Ctrl+Ins> to copy text to the clipboard.
4617
4055
4618
<p>The <Ctrl+A> key can be bound to different actions, too.
4056
<p><a name="index-Ctrl_002bA-is-434"></a>The <Ctrl+A> key can be bound to different actions, too.
4619
4057
4620
4058
<dl>
4621
<dt><code>Select All</code>
4622
<dd>This (default) setting binds <Ctrl+A> to the <code>Select All</code>
4059
<dt><code>Select All</code><dd><a name="index-Home-435"></a>This (default) setting binds <Ctrl+A> to the ‘<samp><span class="samp">Select All</span></samp>’
4623
4060
operation, as specified by the KDE style guide. In this setting, use
4624
4061
<Home> to move the cursor to the beginning of a line.
4625
4062
4626
<br><dt><code>Beginning of Line</code>
4627
<dd>This setting binds <Ctrl+A> to the <code>Beginning of Line</code>
4628
operation, as used in several <small>UNIX</small> text-editing programs. In this
4063
<br><dt><code>Beginning of Line</code><dd><a name="index-Ctrl_002bShift_002bA-436"></a>This setting binds <Ctrl+A> to the ‘<samp><span class="samp">Beginning of Line</span></samp>’
4064
operation, as used in several <acronym>UNIX</acronym> text-editing programs. In this
4629
4065
setting, use <Ctrl+Shift+A> to select all text.
4630
4066
</dl>
4631
4067
4632
<p>Here are the related <small>DDD</small> resources:
4068
<p>Here are the related <acronym>DDD</acronym> resources:
4633
4069
4634
<p>
4635
<table width="100%">
4636
<tr>
4637
<td align="left"><b>cutCopyPasteBindings</b><i> </i>(<i>class BindingStyle</i>)<i>
4638
</i></td>
4639
<td align="right">Resource</td>
4640
</tr>
4641
</table>
4642
<table width="95%" align="center">
4643
<tr><td>
4644
Controls the key bindings for clipboard operations.
4070
<div class="defun">
4071
— Resource: <b>cutCopyPasteBindings</b> (<var>class BindingStyle</var>)<var><a name="index-cutCopyPasteBindings-437"></a></var><br>
4072
<blockquote><p>Controls the key bindings for clipboard operations.
4645
4073
4646
4074
<ul>
4647
<li>If this is <code>Motif</code> (default), Cut/Copy/Paste is on
4075
<li>If this is ‘<samp><span class="samp">Motif</span></samp>’ (default), Cut/Copy/Paste is on
4648
4076
<Shift+Del>/<Ctrl+Ins>/<Shift+Ins>. This is conformant to
4649
4077
the M*tif style guide.
4650
<li>If this is <code>KDE</code>, Cut/Copy/Paste is on
4078
<li>If this is ‘<samp><span class="samp">KDE</span></samp>’, Cut/Copy/Paste is on
4651
4079
<Ctrl+X>/<Ctrl+C>/<Ctrl+V>. This is conformant to the KDE
4652
4080
style guide. Note that this means that <Ctrl+C> no longer
4653
4081
interrupts the debuggee; use <ESC> instead.
4654
4082
</ul>
4655
</td></tr>
4656
</table>
4083
</p></blockquote></div>
4657
4084
4658
<p>
4659
<table width="100%">
4660
<tr>
4661
<td align="left"><b>selectAllBindings</b><i> </i>(<i>class BindingStyle</i>)<i>
4662
</i></td>
4663
<td align="right">Resource</td>
4664
</tr>
4665
</table>
4666
<table width="95%" align="center">
4667
<tr><td>
4668
Controls the key bindings for the <code>Select All</code> operation.
4085
<div class="defun">
4086
— Resource: <b>selectAllBindings</b> (<var>class BindingStyle</var>)<var><a name="index-selectAllBindings-438"></a></var><br>
4087
<blockquote><p>Controls the key bindings for the ‘<samp><span class="samp">Select All</span></samp>’ operation.
4669
4088
4670
4089
<ul>
4671
<li>If this is <code>Motif</code>, Select All is on <Shift+Ctrl+A>.
4672
<li>If this is <code>KDE</code> (default), Select All is on <Ctrl+A>. This is
4090
<li>If this is ‘<samp><span class="samp">Motif</span></samp>’, Select All is on <Shift+Ctrl+A>.
4091
<li>If this is ‘<samp><span class="samp">KDE</span></samp>’ (default), Select All is on <Ctrl+A>. This is
4673
4092
conformant to the KDE style guide. Note that this means that
4674
4093
<Ctrl+A> no longer moves the cursor to the beginning of a line; use
4675
4094
<Home> instead.
4676
4095
</ul>
4677
</td></tr>
4678
</table>
4096
</p></blockquote></div>
4679
4097
4680
4098
<div class="node">
4681
4099
<p><hr>
4682
<small class=header>
4683
Node:<a name="Tool%20Bar">Tool Bar</a>,
4684
Next:<a rel="next" accesskey="n" href="#Command%20Tool">Command Tool</a>,
4685
Previous:<a rel="previous" accesskey="p" href="#Menu%20Bar">Menu Bar</a>,
4686
Up:<a rel="up" accesskey="u" href="#Windows">Windows</a>
4100
<a name="Tool-Bar"></a>
4101
Next: <a rel="next" accesskey="n" href="#Command-Tool">Command Tool</a>,
4102
Previous: <a rel="previous" accesskey="p" href="#Menu-Bar">Menu Bar</a>,
4103
Up: <a rel="up" accesskey="u" href="#Windows">Windows</a>
4687
4104
</small>
4688
4105
4689
<br>
4106
4690
4107
</div>
4691
4108
4692
<h3 class="section">The Tool Bar</h3>
4109
<h3 class="section">3.2 The Tool Bar</h3>
4693
4110
4694
<p>Some <small>DDD</small> commands require an <em>argument</em>. This argument
4695
is specified in the <em>argument field</em>, labeled <code>():</code>.
4111
<p>Some <acronym>DDD</acronym> commands require an <em>argument</em>. This argument
4112
is specified in the <em>argument field</em>, labeled ‘<samp><span class="samp">():</span></samp>’.
4696
4113
Basically, there are four ways to set arguments:
4697
4114
4698
4115
<ul>
4699
4116
<li>You can <em>key in</em> the argument manually.
4700
4117
<li>You can <em>paste</em> the current selection into the argument field
4701
4118
(typically using <kbd>mouse button 2</kbd>). To clear old contents
4702
beforehand, click on the <code>():</code> label.
4119
beforehand, click on the ‘<samp><span class="samp">():</span></samp>’ label.
4703
4120
<li>You can <em>select an item</em> from the source and data windows. This
4704
4121
will automatically copy the item to the argument field.
4705
4122
<li>You can select a <em>previously used argument</em> from the drop-down
4706
4123
menu at the right of the argument field.
4707
4124
</ul>
4708
4125
4709
<p>Using <small>GDB</small> and Perl, the argument field provides a completion mechanism.
4126
<p><a name="index-TAB-439"></a>Using <acronym>GDB</acronym> and Perl, the argument field provides a completion mechanism.
4710
4127
You can enter the first few characters of an item an press the <TAB>
4711
4128
key to complete it. Pressing <TAB> again shows alternative
4712
4129
completions.
4717
4134
and holding <em>mouse button 1</em> on such a button will pop up a menu
4718
4135
with further operations.
4719
4136
4720
<br><p>
4137
<pre class="sp">
4138
4139
</pre>
4721
4140
<div align="center"><img src="PICS/ddd-toolbar.jpg" alt="PICS/ddd-toolbar.jpg"></div>
4722
<br><p>
4141
<pre class="sp">
4142
4143
</pre>
4144
4723
4145
<p>These are the buttons of the tool bar. Note that not all buttons may be
4724
4146
inactive, depending on the current state and the capabilities of the
4725
4147
inferior debugger.
4726
4148
4727
4149
<dl>
4728
<dt><code>Lookup</code>
4729
<dd>
4730
4731
<p>Look up the argument <code>()</code> in the source code. See <a href="#Looking%20up%20Definitions">Looking up Definitions</a>, for details.
4732
4733
<br><dt><code>Find >></code>
4734
<dd>
4735
4736
<p>Look up the next occurrence of the argument <code>()</code> in the current
4737
source code. See <a href="#Textual%20Search">Textual Search</a>, for details.
4738
4739
<br><dt><code>Break/Clear</code>
4740
<dd>
4741
4742
<p>Toggle a breakpoint (see <a href="#Breakpoints">Breakpoints</a>) at the location <code>()</code>.
4150
<dt><code>Lookup</code><dd><a name="index-Lookup-440"></a><a name="index-Looking-up-items-441"></a>
4151
Look up the argument ‘<samp><span class="samp">()</span></samp>’ in the source code. See <a href="#Looking-up-Definitions">Looking up Definitions</a>, for details.
4152
4153
<br><dt><code>Find >></code><dd><a name="index-Find-_003e_003e-442"></a><a name="index-Finding-items-443"></a><a name="index-Search_002c-using-_0040samp_007bFind-_003e_003e_007d-444"></a>
4154
Look up the next occurrence of the argument ‘<samp><span class="samp">()</span></samp>’ in the current
4155
source code. See <a href="#Textual-Search">Textual Search</a>, for details.
4156
4157
<br><dt><code>Break/Clear</code><dd><a name="index-Breakpoint_002c-toggling-445"></a>
4158
Toggle a breakpoint (see <a href="#Breakpoints">Breakpoints</a>) at the location ‘<samp><span class="samp">()</span></samp>’.
4743
4159
4744
4160
<dl>
4745
<dt><code>Break</code>
4746
<dd>If there is no breakpoint at <code>()</code>, then this button is labeled
4747
<code>Break</code>. Clicking on <code>Break</code> sets a breakpoint at the
4748
location <code>()</code>. See <a href="#Setting%20Breakpoints">Setting Breakpoints</a>, for details.
4161
<dt><code>Break</code><dd><a name="index-Break-446"></a>If there is no breakpoint at ‘<samp><span class="samp">()</span></samp>’, then this button is labeled
4162
‘<samp><span class="samp">Break</span></samp>’. Clicking on ‘<samp><span class="samp">Break</span></samp>’ sets a breakpoint at the
4163
location ‘<samp><span class="samp">()</span></samp>’. See <a href="#Setting-Breakpoints">Setting Breakpoints</a>, for details.
4749
4164
4750
<br><dt><code>Clear</code>
4751
<dd>If there already is a breakpoint at <code>()</code>, then this button is
4752
labeled <code>Clear</code>. Clicking on <code>Clear</code> clears (deletes) the
4753
breakpoint at the location <code>()</code>. See <a href="#Deleting%20Breakpoints">Deleting Breakpoints</a>, for
4165
<br><dt><code>Clear</code><dd><a name="index-Clear-447"></a>If there already is a breakpoint at ‘<samp><span class="samp">()</span></samp>’, then this button is
4166
labeled ‘<samp><span class="samp">Clear</span></samp>’. Clicking on ‘<samp><span class="samp">Clear</span></samp>’ clears (deletes) the
4167
breakpoint at the location ‘<samp><span class="samp">()</span></samp>’. See <a href="#Deleting-Breakpoints">Deleting Breakpoints</a>, for
4754
4168
details.
4755
4169
</dl>
4756
4170
4757
<br><dt><code>Watch/Unwatch</code>
4758
<dd>
4759
4760
<p>Toggle a watchpoint (see <a href="#Watchpoints">Watchpoints</a>) on the expression <code>()</code>.
4171
<br><dt><code>Watch/Unwatch</code><dd><a name="index-Watchpoint_002c-toggling-448"></a>
4172
Toggle a watchpoint (see <a href="#Watchpoints">Watchpoints</a>) on the expression ‘<samp><span class="samp">()</span></samp>’.
4761
4173
4762
4174
<dl>
4763
<dt><code>Watch</code>
4764
<dd>If <code>()</code> is not being watched, then this button is labeled
4765
<code>Watch</code>. Clicking on <code>Watch</code> creates a watchpoint on the
4766
expression <code>()</code>. See <a href="#Setting%20Watchpoints">Setting Watchpoints</a>, for details.
4175
<dt><code>Watch</code><dd><a name="index-Watch-449"></a>If ‘<samp><span class="samp">()</span></samp>’ is not being watched, then this button is labeled
4176
‘<samp><span class="samp">Watch</span></samp>’. Clicking on ‘<samp><span class="samp">Watch</span></samp>’ creates a watchpoint on the
4177
expression ‘<samp><span class="samp">()</span></samp>’. See <a href="#Setting-Watchpoints">Setting Watchpoints</a>, for details.
4767
4178
4768
<br><dt><code>Unwatch</code>
4769
<dd>If <code>()</code> is being watched, then this button is labeled
4770
<code>Unwatch</code>. Clicking on <code>Unwatch</code> clears (deletes) the
4771
watchpoint on <code>()</code>. See <a href="#Deleting%20Watchpoints">Deleting Watchpoints</a>, for details.
4179
<br><dt><code>Unwatch</code><dd><a name="index-Unwatch-450"></a>If ‘<samp><span class="samp">()</span></samp>’ is being watched, then this button is labeled
4180
‘<samp><span class="samp">Unwatch</span></samp>’. Clicking on ‘<samp><span class="samp">Unwatch</span></samp>’ clears (deletes) the
4181
watchpoint on ‘<samp><span class="samp">()</span></samp>’. See <a href="#Deleting-Watchpoints">Deleting Watchpoints</a>, for details.
4772
4182
</dl>
4773
4183
4774
<br><dt><code>Print</code>
4775
<dd>
4776
4777
<p>Print the value of <code>()</code> in the debugger console. See <a href="#Printing%20Values">Printing Values</a>, for details.
4778
4779
<br><dt><code>Display</code>
4780
<dd>
4781
4782
<p>Display the value of <code>()</code> in the data window. See <a href="#Displaying%20Values">Displaying Values</a>, for details.
4783
4784
<br><dt><code>Plot</code>
4785
<dd>
4786
4787
<p>Plot <code>()</code> in a plot window. See <a href="#Plotting%20Values">Plotting Values</a>, for details.
4788
4789
<br><dt><code>Show/Hide</code>
4790
<dd>
4791
4792
<p>Toggle details of the selected display(s). See <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>, for a discussion.
4793
4794
<br><dt><code>Rotate</code>
4795
<dd>
4796
4797
<p>Rotate the selected display(s). See <a href="#Rotating%20Displays">Rotating Displays</a>, for details.
4798
4799
<br><dt><code>Set</code>
4800
<dd>
4801
4802
<p>Set (change) the value of <code>()</code>. See <a href="#Assignment">Assignment</a>, for details.
4803
4804
<br><dt><code>Undisp</code>
4805
<dd>
4806
4807
<p>Undisplay (delete) the selected display(s). See <a href="#Deleting%20Displays">Deleting Displays</a>,
4184
<br><dt><code>Print</code><dd><a name="index-Print-451"></a><a name="index-Values_002c-printing-with-_0040samp_007bPrint_007d-452"></a><a name="index-Printing-values-with-_0040samp_007bPrint_007d-453"></a>
4185
Print the value of ‘<samp><span class="samp">()</span></samp>’ in the debugger console. See <a href="#Printing-Values">Printing Values</a>, for details.
4186
4187
<br><dt><code>Display</code><dd><a name="index-Display-454"></a><a name="index-Values_002c-displaying-with-_0040samp_007bDisplay_007d-455"></a><a name="index-Displaying-values-with-_0040samp_007bDisplay_007d-456"></a><a name="index-Display_002c-creating-457"></a>
4188
Display the value of ‘<samp><span class="samp">()</span></samp>’ in the data window. See <a href="#Displaying-Values">Displaying Values</a>, for details.
4189
4190
<br><dt><code>Plot</code><dd><a name="index-Plot-458"></a><a name="index-Values_002c-plotting-with-_0040samp_007bPlot_007d-459"></a><a name="index-Plotting-values-460"></a>
4191
Plot ‘<samp><span class="samp">()</span></samp>’ in a plot window. See <a href="#Plotting-Values">Plotting Values</a>, for details.
4192
4193
<br><dt><code>Show/Hide</code><dd><a name="index-Show-461"></a><a name="index-Hide-462"></a><a name="index-Display_002c-toggling-detail-463"></a><a name="index-Detail-toggling-with-_0040samp_007bShow_002fHide_007d-464"></a>
4194
Toggle details of the selected display(s). See <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a>, for a discussion.
4195
4196
<br><dt><code>Rotate</code><dd><a name="index-Rotate-465"></a><a name="index-Display_002c-rotating-466"></a><a name="index-Rotating-displays-with-_0040samp_007bRotate_007d-467"></a>
4197
Rotate the selected display(s). See <a href="#Rotating-Displays">Rotating Displays</a>, for details.
4198
4199
<br><dt><code>Set</code><dd><a name="index-Set-468"></a><a name="index-Display_002c-setting-469"></a><a name="index-Setting-variables-with-_0040samp_007bSet_007d-470"></a><a name="index-Variables_002c-setting-with-_0040samp_007bSet_007d-471"></a>
4200
Set (change) the value of ‘<samp><span class="samp">()</span></samp>’. See <a href="#Assignment">Assignment</a>, for details.
4201
4202
<br><dt><code>Undisp</code><dd><a name="index-Undisp-472"></a><a name="index-Display_002c-deleting-473"></a><a name="index-Deleting-displays-474"></a>
4203
Undisplay (delete) the selected display(s). See <a href="#Deleting-Displays">Deleting Displays</a>,
4808
4204
for details.
4809
4205
</dl>
4810
4206
4811
4207
<ul class="menu">
4812
<li><a accesskey="1" href="#Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>:
4208
<li><a accesskey="1" href="#Customizing-the-Tool-Bar">Customizing the Tool Bar</a>
4813
4209
</ul>
4814
4210
4815
4211
<div class="node">
4816
4212
<p><hr>
4817
<small class=header>
4818
Node:<a name="Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>,
4819
Up:<a rel="up" accesskey="u" href="#Tool%20Bar">Tool Bar</a>
4213
<a name="Customizing-the-Tool-Bar"></a>
4214
Up: <a rel="up" accesskey="u" href="#Tool-Bar">Tool Bar</a>
4820
4215
</small>
4821
4216
4822
<br>
4217
4823
4218
</div>
4824
4219
4825
<h4 class="subsection">Customizing the Tool Bar</h4>
4220
<h4 class="subsection">3.2.1 Customizing the Tool Bar</h4>
4826
4221
4827
<p>The <small>DDD</small> tool bar buttons can appear in a variety of styles,
4828
customized via <code>Edit => Preferences => Startup</code>.
4222
<p>The <acronym>DDD</acronym> tool bar buttons can appear in a variety of styles,
4223
customized via ‘<samp><span class="samp">Edit Preferences Startup</span></samp>’.
4829
4224
4830
4225
<dl>
4831
<dt><code>Images</code>
4832
<dd>This lets each tool bar button show an image illustrating the action.
4226
<dt><code>Images</code><dd>This lets each tool bar button show an image illustrating the action.
4833
4227
4834
<br><dt><code>Captions</code>
4835
<dd>This shows the action name below the image.
4228
<br><dt><code>Captions</code><dd>This shows the action name below the image.
4836
4229
</dl>
4837
4230
4838
4231
<p>The default is to have images as well as captions, but you can choose to
4839
4232
have only images (saving space) or only captions.
4840
4233
4841
<br><p>
4234
<pre class="sp">
4235
4236
</pre>
4842
4237
<div align="center"><img src="PICS/ddd-toolbars.jpg" alt="PICS/ddd-toolbars.jpg"></div>
4843
<br><p>
4844
<p>If you choose to have neither images nor captions, tool bar buttons are
4845
labeled like other buttons, as in <small>DDD</small> 2.x. Note that this
4238
<pre class="sp">
4239
4240
</pre>
4241
4242
If you choose to have neither images nor captions, tool bar buttons are
4243
labeled like other buttons, as in <acronym>DDD</acronym> 2.x. Note that this
4846
4244
implies that in the stacked window configuration, the common tool bar
4847
4245
cannot be displayed; it is replaced by two separate tool bars, as in
4848
<small>DDD</small> 2.x.
4246
<acronym>DDD</acronym> 2.x.
4849
4247
4850
<p>If you enable <code>Flat</code> buttons (default), the border of tool bar
4248
<p>If you enable ‘<samp><span class="samp">Flat</span></samp>’ buttons (default), the border of tool bar
4851
4249
buttons will appear only if the mouse pointer is over them. This
4852
latest-and-greatest <small>GUI</small> invention can be disabled, such that
4250
latest-and-greatest <acronym>GUI</acronym> invention can be disabled, such that
4853
4251
the button border is always shown.
4854
4252
4855
<p>If you enable <code>Color</code> buttons, tool bar images will be colored when
4856
entered. If <small>DDD</small> was built using M*tif 2.0 and later, you can
4253
<p>If you enable ‘<samp><span class="samp">Color</span></samp>’ buttons, tool bar images will be colored when
4254
entered. If <acronym>DDD</acronym> was built using M*tif 2.0 and later, you can
4857
4255
also choose a third setting, where buttons appear in color all the time.
4858
4256
4859
4257
<p>Here are the related resources (see <a href="#Customizing">Customizing</a>):
4860
4258
4861
<p>
4862
<table width="100%">
4863
<tr>
4864
<td align="left"><b>activeButtonColorKey</b><i> </i>(<i>class ColorKey</i>)<i>
4865
</i></td>
4866
<td align="right">Resource</td>
4867
</tr>
4868
</table>
4869
<table width="95%" align="center">
4870
<tr><td>
4871
The <small>XPM</small> color key to use for the images of active buttons
4872
(entered or armed). <code>c</code> means color, <code>g</code> (default) means
4873
grey, and <code>m</code> means monochrome.
4874
</td></tr>
4875
</table>
4259
<div class="defun">
4260
— Resource: <b>activeButtonColorKey</b> (<var>class ColorKey</var>)<var><a name="index-activeButtonColorKey-475"></a></var><br>
4261
<blockquote><p>The <acronym>XPM</acronym> color key to use for the images of active buttons
4262
(entered or armed). ‘<samp><span class="samp">c</span></samp>’ means color, ‘<samp><span class="samp">g</span></samp>’ (default) means
4263
grey, and ‘<samp><span class="samp">m</span></samp>’ means monochrome.
4264
</p></blockquote></div>
4876
4265
4877
<p>
4878
<table width="100%">
4879
<tr>
4880
<td align="left"><b>buttonCaptions</b><i> </i>(<i>class ButtonCaptions</i>)<i>
4881
</i></td>
4882
<td align="right">Resource</td>
4883
</tr>
4884
</table>
4885
<table width="95%" align="center">
4886
<tr><td>
4887
Whether the tool bar buttons should be shown using captions
4888
(<code>on</code>, default) or not (<code>off</code>). If neither captions nor
4266
<div class="defun">
4267
— Resource: <b>buttonCaptions</b> (<var>class ButtonCaptions</var>)<var><a name="index-buttonCaptions-476"></a></var><br>
4268
<blockquote><p>Whether the tool bar buttons should be shown using captions
4269
(‘<samp><span class="samp">on</span></samp>’, default) or not (‘<samp><span class="samp">off</span></samp>’). If neither captions nor
4889
4270
images are enabled, tool bar buttons are shown using ordinary labels.
4890
See also <code>buttonImages</code>, below.
4891
</td></tr>
4892
</table>
4893
4894
<p>
4895
<table width="100%">
4896
<tr>
4897
<td align="left"><b>buttonCaptionGeometry</b><i> </i>(<i>class ButtonCaptionGeometry</i>)<i>
4898
</i></td>
4899
<td align="right">Resource</td>
4900
</tr>
4901
</table>
4902
<table width="95%" align="center">
4903
<tr><td>
4904
The geometry of the caption subimage within the button icons. Default
4905
is <code>29x7+0-0</code>.
4906
</td></tr>
4907
</table>
4908
4909
<p>
4910
<table width="100%">
4911
<tr>
4912
<td align="left"><b>buttonImages</b><i> </i>(<i>class ButtonImages</i>)<i>
4913
</i></td>
4914
<td align="right">Resource</td>
4915
</tr>
4916
</table>
4917
<table width="95%" align="center">
4918
<tr><td>
4919
Whether the tool bar buttons should be shown using images (<code>on</code>,
4920
default) or not (<code>off</code>). If neither captions nor images are
4271
See also ‘<samp><span class="samp">buttonImages</span></samp>’, below.
4272
</p></blockquote></div>
4273
4274
<div class="defun">
4275
— Resource: <b>buttonCaptionGeometry</b> (<var>class ButtonCaptionGeometry</var>)<var><a name="index-buttonCaptionGeometry-477"></a></var><br>
4276
<blockquote><p>The geometry of the caption subimage within the button icons. Default
4277
is ‘<samp><span class="samp">29x7+0-0</span></samp>’.
4278
</p></blockquote></div>
4279
4280
<div class="defun">
4281
— Resource: <b>buttonImages</b> (<var>class ButtonImages</var>)<var><a name="index-buttonImages-478"></a></var><br>
4282
<blockquote><p>Whether the tool bar buttons should be shown using images (‘<samp><span class="samp">on</span></samp>’,
4283
default) or not (‘<samp><span class="samp">off</span></samp>’). If neither captions nor images are
4921
4284
enabled, tool bar buttons are shown using ordinary labels. See also
4922
<code>buttonCaptions</code>, above.
4923
</td></tr>
4924
</table>
4925
4926
<p>
4927
<table width="100%">
4928
<tr>
4929
<td align="left"><b>buttonImageGeometry</b><i> </i>(<i>class ButtonImageGeometry</i>)<i>
4930
</i></td>
4931
<td align="right">Resource</td>
4932
</tr>
4933
</table>
4934
<table width="95%" align="center">
4935
<tr><td>
4936
The geometry of the image within the button icon. Default is
4937
<code>25x21+2+0</code>.
4938
</td></tr>
4939
</table>
4940
4941
<p>
4942
<table width="100%">
4943
<tr>
4944
<td align="left"><b>buttonColorKey</b><i> </i>(<i>class ColorKey</i>)<i>
4945
</i></td>
4946
<td align="right">Resource</td>
4947
</tr>
4948
</table>
4949
<table width="95%" align="center">
4950
<tr><td>
4951
The <small>XPM</small> color key to use for the images of inactive buttons
4952
(non-entered or insensitive). <code>c</code> means color, <code>g</code>
4953
(default) means grey, and <code>m</code> means monochrome.
4954
</td></tr>
4955
</table>
4956
4957
<p>
4958
<table width="100%">
4959
<tr>
4960
<td align="left"><b>flatToolbarButtons</b><i> </i>(<i>class FlatButtons</i>)<i>
4961
</i></td>
4962
<td align="right">Resource</td>
4963
</tr>
4964
</table>
4965
<table width="95%" align="center">
4966
<tr><td>
4967
If <code>on</code> (default), all tool bar buttons with images or captions
4968
are given a `flat' appearance--the 3-D border only shows up when the
4969
pointer is over the icon. If <code>off</code>, the 3-D border is shown all
4285
‘<samp><span class="samp">buttonCaptions</span></samp>’, above.
4286
</p></blockquote></div>
4287
4288
<div class="defun">
4289
— Resource: <b>buttonImageGeometry</b> (<var>class ButtonImageGeometry</var>)<var><a name="index-buttonImageGeometry-479"></a></var><br>
4290
<blockquote><p>The geometry of the image within the button icon. Default is
4291
‘<samp><span class="samp">25x21+2+0</span></samp>’.
4292
</p></blockquote></div>
4293
4294
<div class="defun">
4295
— Resource: <b>buttonColorKey</b> (<var>class ColorKey</var>)<var><a name="index-buttonColorKey-480"></a></var><br>
4296
<blockquote><p>The <acronym>XPM</acronym> color key to use for the images of inactive buttons
4297
(non-entered or insensitive). ‘<samp><span class="samp">c</span></samp>’ means color, ‘<samp><span class="samp">g</span></samp>’
4298
(default) means grey, and ‘<samp><span class="samp">m</span></samp>’ means monochrome.
4299
</p></blockquote></div>
4300
4301
<div class="defun">
4302
— Resource: <b>flatToolbarButtons</b> (<var>class FlatButtons</var>)<var><a name="index-flatToolbarButtons-481"></a></var><br>
4303
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), all tool bar buttons with images or captions
4304
are given a `flat' appearance—the 3-D border only shows up when the
4305
pointer is over the icon. If ‘<samp><span class="samp">off</span></samp>’, the 3-D border is shown all
4970
4306
the time.
4971
</td></tr>
4972
</table>
4307
</p></blockquote></div>
4973
4308
4974
<p>
4975
<table width="100%">
4976
<tr>
4977
<td align="left"><b>flatDialogButtons</b><i> </i>(<i>class FlatButtons</i>)<i>
4978
</i></td>
4979
<td align="right">Resource</td>
4980
</tr>
4981
</table>
4982
<table width="95%" align="center">
4983
<tr><td>
4984
If <code>on</code> (default), all dialog buttons with images or captions
4985
are given a `flat' appearance--the 3-D border only shows up when
4986
the pointer is over the icon. If <code>off</code>, the 3-D border is shown
4309
<div class="defun">
4310
— Resource: <b>flatDialogButtons</b> (<var>class FlatButtons</var>)<var><a name="index-flatDialogButtons-482"></a></var><br>
4311
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), all dialog buttons with images or captions
4312
are given a `flat' appearance—the 3-D border only shows up when
4313
the pointer is over the icon. If ‘<samp><span class="samp">off</span></samp>’, the 3-D border is shown
4987
4314
all the time.
4988
</td></tr>
4989
</table>
4315
</p></blockquote></div>
4990
4316
4991
4317
<div class="node">
4992
4318
<p><hr>
4993
<small class=header>
4994
Node:<a name="Command%20Tool">Command Tool</a>,
4995
Next:<a rel="next" accesskey="n" href="#Getting%20Help">Getting Help</a>,
4996
Previous:<a rel="previous" accesskey="p" href="#Tool%20Bar">Tool Bar</a>,
4997
Up:<a rel="up" accesskey="u" href="#Windows">Windows</a>
4319
<a name="Command-Tool"></a>
4320
Next: <a rel="next" accesskey="n" href="#Getting-Help">Getting Help</a>,
4321
Previous: <a rel="previous" accesskey="p" href="#Tool-Bar">Tool Bar</a>,
4322
Up: <a rel="up" accesskey="u" href="#Windows">Windows</a>
4998
4323
</small>
4999
4324
5000
<br>
4325
5001
4326
</div>
5002
4327
5003
<h3 class="section">The Command Tool</h3>
5004
5005
<p>The command tool is a small window that gives you access to the most
5006
frequently used <small>DDD</small> commands. It can be moved around on top of
5007
the <small>DDD</small> windows, but it can also be placed besides them.
5008
5009
<p>By default, the command tool <em>sticks</em> to the <small>DDD</small> source
5010
window: Whenever you move the <small>DDD</small> source window, the command
4328
<h3 class="section">3.3 The Command Tool</h3>
4329
4330
<p>The command tool is a small window that gives you access to the most
4331
frequently used <acronym>DDD</acronym> commands. It can be moved around on top of
4332
the <acronym>DDD</acronym> windows, but it can also be placed besides them.
4333
4334
<p>By default, the command tool <em>sticks</em> to the <acronym>DDD</acronym> source
4335
window: Whenever you move the <acronym>DDD</acronym> source window, the command
5011
4336
tool follows such that the distance between source window and command
5012
4337
tool remains the same. By default, the command tool is also
5013
<em>auto-raised</em>, such that it stays on top of other <small>DDD</small>
4338
<em>auto-raised</em>, such that it stays on top of other <acronym>DDD</acronym>
5014
4339
windows.
5015
4340
5016
4341
<p>The command tool can be configured to appear as a command tool bar above
5017
the source window; see <code>Edit => Preferences => Source
5018
=> Tool Buttons Location</code> for details.
4342
the source window; see ‘<samp><span class="samp">Edit Preferences Source
4343
Tool Buttons Location</span></samp>’ for details.
5019
4344
5020
<p>Whenever you save <small>DDD</small> state, <small>DDD</small> also saves the distance
4345
<p>Whenever you save <acronym>DDD</acronym> state, <acronym>DDD</acronym> also saves the distance
5021
4346
between command tool and source window, such that you can select your
5022
4347
own individual command tool placement. To move the command tool to its
5023
saved position, use <code>View => Command Tool</code>.
5024
5025
<br><p>
4348
saved position, use ‘<samp><span class="samp">View Command Tool</span></samp>’.
4349
4350
<pre class="sp">
4351
4352
</pre>
5026
4353
<div align="center"><img src="PICS/ddd-tool.jpg" alt="PICS/ddd-tool.jpg"></div>
5027
<br><p>
5028
<p>These are the buttons of the command tool. Note that not all buttons
4354
<pre class="sp">
4355
4356
</pre>
4357
4358
These are the buttons of the command tool. Note that not all buttons
5029
4359
may be inactive, depending on the current state and the capabilities of
5030
4360
the inferior debugger.
5031
4361
5032
4362
<dl>
5033
<dt><code>Run</code>
5034
<dd>Start program execution. When you click this button, your program will
5035
begin to execute immediately. See <a href="#Starting%20Program%20Execution">Starting Program Execution</a>, for
4363
<dt><code>Run</code><dd><a name="index-Run-483"></a>Start program execution. When you click this button, your program will
4364
begin to execute immediately. See <a href="#Starting-Program-Execution">Starting Program Execution</a>, for
5036
4365
details.
5037
4366
5038
<br><dt><code>Interrupt</code>
5039
<dd>Interrupt program execution. This is equivalent to sending an interrupt
4367
<br><dt><code>Interrupt</code><dd><a name="index-Interrupt-484"></a>Interrupt program execution. This is equivalent to sending an interrupt
5040
4368
signal to the process. See <a href="#Interrupting">Interrupting</a>, for details.
5041
4369
5042
<br><dt><code>Step</code>
5043
<dd>Continue running your program until control reaches a different source
5044
line, then stop it and return control to <small>DDD</small>. See <a href="#Resuming%20Execution">Resuming Execution</a>, for details.
5045
5046
<br><dt><code>Stepi</code>
5047
<dd>Execute one machine instruction, then stop and return to <small>DDD</small>.
5048
See <a href="#Machine%20Code%20Execution">Machine Code Execution</a>, for details.
5049
5050
<br><dt><code>Next</code>
5051
<dd>Continue to the next source line in the current (innermost) stack
5052
frame. This is similar to <code>Step</code>, but function calls that appear
4370
<br><dt><code>Step</code><dd><a name="index-Step-485"></a>Continue running your program until control reaches a different source
4371
line, then stop it and return control to <acronym>DDD</acronym>. See <a href="#Resuming-Execution">Resuming Execution</a>, for details.
4372
4373
<br><dt><code>Stepi</code><dd><a name="index-Stepi-486"></a>Execute one machine instruction, then stop and return to <acronym>DDD</acronym>.
4374
See <a href="#Machine-Code-Execution">Machine Code Execution</a>, for details.
4375
4376
<br><dt><code>Next</code><dd><a name="index-Next-487"></a>Continue to the next source line in the current (innermost) stack
4377
frame. This is similar to ‘<samp><span class="samp">Step</span></samp>’, but function calls that appear
5053
4378
within the line of code are executed without stopping.
5054
See <a href="#Resuming%20Execution">Resuming Execution</a>, for details.
4379
See <a href="#Resuming-Execution">Resuming Execution</a>, for details.
5055
4380
5056
<br><dt><code>Nexti</code>
5057
<dd>Execute one machine instruction, but if it is a function call,
4381
<br><dt><code>Nexti</code><dd><a name="index-Nexti-488"></a>Execute one machine instruction, but if it is a function call,
5058
4382
proceed until the function returns.
5059
See <a href="#Machine%20Code%20Execution">Machine Code Execution</a>, for details.
5060
5061
<br><dt><code>Until</code>
5062
<dd>Continue running until a source line past the current line, in the
5063
current stack frame, is reached. See <a href="#Resuming%20Execution">Resuming Execution</a>, for details.
5064
5065
<br><dt><code>Finish</code>
5066
<dd>Continue running until just after function in the selected stack frame
5067
returns. Print the returned value (if any). See <a href="#Resuming%20Execution">Resuming Execution</a>,
4383
See <a href="#Machine-Code-Execution">Machine Code Execution</a>, for details.
4384
4385
<br><dt><code>Until</code><dd><a name="index-Until-489"></a>Continue running until a source line past the current line, in the
4386
current stack frame, is reached. See <a href="#Resuming-Execution">Resuming Execution</a>, for details.
4387
4388
<br><dt><code>Finish</code><dd><a name="index-Finish-490"></a>Continue running until just after function in the selected stack frame
4389
returns. Print the returned value (if any). See <a href="#Resuming-Execution">Resuming Execution</a>,
5068
4390
for details.
5069
4391
5070
<br><dt><code>Cont</code>
5071
<dd>Resume program execution, at the address where your program last
4392
<br><dt><code>Cont</code><dd><a name="index-Cont-491"></a>Resume program execution, at the address where your program last
5072
4393
stopped; any breakpoints set at that address are bypassed.
5073
See <a href="#Resuming%20Execution">Resuming Execution</a>, for details.
4394
See <a href="#Resuming-Execution">Resuming Execution</a>, for details.
5074
4395
5075
<br><dt><code>Kill</code>
5076
<dd>Kill the process of the debugged program. See <a href="#Killing%20the%20Program">Killing the Program</a>,
4396
<br><dt><code>Kill</code><dd><a name="index-Kill-492"></a>Kill the process of the debugged program. See <a href="#Killing-the-Program">Killing the Program</a>,
5077
4397
for details.
5078
4398
5079
<br><dt><code>Up</code>
5080
<dd>Select the stack frame (i.e. the function) that called this one. This
4399
<br><dt><code>Up</code><dd><a name="index-Up-493"></a>Select the stack frame (i.e. the function) that called this one. This
5081
4400
advances toward the outermost frame, to higher frame numbers, to frames
5082
4401
that have existed longer. See <a href="#Stack">Stack</a>, for details.
5083
4402
5084
<br><dt><code>Down</code>
5085
<dd>Select the stack frame (i.e. the function) that was called by this one.
4403
<br><dt><code>Down</code><dd><a name="index-Down-494"></a>Select the stack frame (i.e. the function) that was called by this one.
5086
4404
This advances toward the innermost frame, to lower frame numbers, to
5087
4405
frames that were created more recently. See <a href="#Stack">Stack</a>, for details.
5088
4406
5089
<br><dt><code>Undo</code>
5090
<dd>Undo the most recent action. Almost all commands can be undone this
5091
way. See <a href="#Undo%20and%20Redo">Undo and Redo</a>, for details.
5092
5093
<br><dt><code>Redo</code>
5094
<dd>Redo the action most recently undone. Every command undone can be
5095
redone this way. See <a href="#Undo%20and%20Redo">Undo and Redo</a>, for details.
5096
5097
<br><dt><code>Edit</code>
5098
<dd>Invoke an editor for the current source file. See <a href="#Editing%20Source%20Code">Editing Source Code</a>, for details.
5099
5100
<br><dt><code>Make</code>
5101
<dd>Run the <code>make</code> program with the most recently given arguments.
4407
<br><dt><code>Undo</code><dd><a name="index-Undo-495"></a>Undo the most recent action. Almost all commands can be undone this
4408
way. See <a href="#Undo-and-Redo">Undo and Redo</a>, for details.
4409
4410
<br><dt><code>Redo</code><dd><a name="index-Redo-496"></a>Redo the action most recently undone. Every command undone can be
4411
redone this way. See <a href="#Undo-and-Redo">Undo and Redo</a>, for details.
4412
4413
<br><dt><code>Edit</code><dd><a name="index-Edit-497"></a>Invoke an editor for the current source file. See <a href="#Editing-Source-Code">Editing Source Code</a>, for details.
4414
4415
<br><dt><code>Make</code><dd><a name="index-Make-498"></a>Run the <code>make</code> program with the most recently given arguments.
5102
4416
See <a href="#Recompiling">Recompiling</a>, for details.
5103
4417
</dl>
5104
4418
5105
4419
<ul class="menu">
5106
<li><a accesskey="1" href="#Customizing%20the%20Command%20Tool">Customizing the Command Tool</a>:
5107
<li><a accesskey="2" href="#Customizing%20Tool%20Position">Customizing Tool Position</a>:
4420
<li><a accesskey="1" href="#Customizing-the-Command-Tool">Customizing the Command Tool</a>
4421
<li><a accesskey="2" href="#Customizing-Tool-Position">Customizing Tool Position</a>
5108
4422
</ul>
5109
4423
5110
4424
<div class="node">
5111
4425
<p><hr>
5112
<small class=header>
5113
Node:<a name="Customizing%20the%20Command%20Tool">Customizing the Command Tool</a>,
5114
Next:<a rel="next" accesskey="n" href="#Customizing%20Tool%20Position">Customizing Tool Position</a>,
5115
Up:<a rel="up" accesskey="u" href="#Command%20Tool">Command Tool</a>
4426
<a name="Customizing-the-Command-Tool"></a>
4427
Next: <a rel="next" accesskey="n" href="#Customizing-Tool-Position">Customizing Tool Position</a>,
4428
Up: <a rel="up" accesskey="u" href="#Command-Tool">Command Tool</a>
5116
4429
</small>
5117
4430
5118
<br>
4431
5119
4432
</div>
5120
4433
5121
<h4 class="subsection">Customizing the Command Tool</h4>
4434
<h4 class="subsection">3.3.1 Customizing the Command Tool</h4>
5122
4435
5123
<p>The Command Tool can be customized in various ways.
4436
<p>The Command Tool can be customized in various ways.
5124
4437
5125
4438
<ul class="menu">
5126
<li><a accesskey="1" href="#Disabling%20the%20Command%20Tool">Disabling the Command Tool</a>:
4439
<li><a accesskey="1" href="#Disabling-the-Command-Tool">Disabling the Command Tool</a>
5127
4440
</ul>
5128
4441
5129
<p>See <a href="#Customizing%20Buttons">Customizing Buttons</a>, for details on customizing the tool buttons.
4442
<p>See <a href="#Customizing-Buttons">Customizing Buttons</a>, for details on customizing the tool buttons.
5130
4443
5131
4444
<div class="node">
5132
4445
<p><hr>
5133
<small class=header>
5134
Node:<a name="Disabling%20the%20Command%20Tool">Disabling the Command Tool</a>,
5135
Up:<a rel="up" accesskey="u" href="#Customizing%20the%20Command%20Tool">Customizing the Command Tool</a>
4446
<a name="Disabling-the-Command-Tool"></a>
4447
Up: <a rel="up" accesskey="u" href="#Customizing-the-Command-Tool">Customizing the Command Tool</a>
5136
4448
</small>
5137
4449
5138
<br>
4450
5139
4451
</div>
5140
4452
5141
<h5 class="subsubsection">Disabling the Command Tool</h5>
5142
5143
<p>You can disable the command tool and show its buttons in a separate row
5144
beneath the tool bar. To disable the command tool, set <code>Edit
5145
=> Preferences => Source => Tool Buttons Location
5146
=> Source Window</code>.
5147
5148
<br><p>
4453
<h5 class="subsubsection">3.3.1.1 Disabling the Command Tool</h5>
4454
4455
<p><a name="index-Tool-Buttons-Location-499"></a>You can disable the command tool and show its buttons in a separate row
4456
beneath the tool bar. To disable the command tool, set ‘<samp><span class="samp">Edit
4457
Preferences Source Tool Buttons Location
4458
Source Window</span></samp>’.
4459
4460
<pre class="sp">
4461
4462
</pre>
5149
4463
<div align="center"><img src="PICS/ddd-source-prefs.jpg" alt="PICS/ddd-source-prefs.jpg"></div>
5150
<br><p>
5151
<p>Here's the related resource:
5152
5153
<p>
5154
<table width="100%">
5155
<tr>
5156
<td align="left"><b>commandToolBar</b><i> </i>(<i>class ToolBar</i>)<i>
5157
</i></td>
5158
<td align="right">Resource</td>
5159
</tr>
5160
</table>
5161
<table width="95%" align="center">
5162
<tr><td>
5163
Whether the tool buttons should be shown in a tool bar above the source
5164
window (<code>on</code>) or within the command tool (<code>off</code>, default).
4464
<pre class="sp">
4465
4466
</pre>
4467
4468
Here's the related resource:
4469
4470
<div class="defun">
4471
— Resource: <b>commandToolBar</b> (<var>class ToolBar</var>)<var><a name="index-commandToolBar-500"></a></var><br>
4472
<blockquote><p>Whether the tool buttons should be shown in a tool bar above the source
4473
window (‘<samp><span class="samp">on</span></samp>’) or within the command tool (‘<samp><span class="samp">off</span></samp>’, default).
5165
4474
Enabling the command tool bar disables the command tool and vice versa.
5166
</td></tr>
5167
</table>
4475
</p></blockquote></div>
5168
4476
5169
4477
<div class="node">
5170
4478
<p><hr>
5171
<small class=header>
5172
Node:<a name="Customizing%20Tool%20Position">Customizing Tool Position</a>,
5173
Previous:<a rel="previous" accesskey="p" href="#Customizing%20the%20Command%20Tool">Customizing the Command Tool</a>,
5174
Up:<a rel="up" accesskey="u" href="#Command%20Tool">Command Tool</a>
4479
<a name="Customizing-Tool-Position"></a>
4480
Previous: <a rel="previous" accesskey="p" href="#Customizing-the-Command-Tool">Customizing the Command Tool</a>,
4481
Up: <a rel="up" accesskey="u" href="#Command-Tool">Command Tool</a>
5175
4482
</small>
5176
4483
5177
<br>
4484
5178
4485
</div>
5179
4486
5180
<h4 class="subsection">Command Tool Position</h4>
4487
<h4 class="subsection">3.3.2 Command Tool Position</h4>
5181
4488
5182
<p>The following resources control the position of the command tool
4489
<p>The following resources control the position of the command tool
5183
4490
(see <a href="#Customizing">Customizing</a>):
5184
4491
5185
<p>
5186
<table width="100%">
5187
<tr>
5188
<td align="left"><b>autoRaiseTool</b><i> </i>(<i>class AutoRaiseTool</i>)<i>
5189
</i></td>
5190
<td align="right">Resource</td>
5191
</tr>
5192
</table>
5193
<table width="95%" align="center">
5194
<tr><td>
5195
If <code>on</code> (default), <small>DDD</small> will always keep the command tool on
5196
top of other <small>DDD</small> windows. If this setting interferes with your
4492
<div class="defun">
4493
— Resource: <b>autoRaiseTool</b> (<var>class AutoRaiseTool</var>)<var><a name="index-autoRaiseTool-501"></a></var><br>
4494
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), <acronym>DDD</acronym> will always keep the command tool on
4495
top of other <acronym>DDD</acronym> windows. If this setting interferes with your
5197
4496
window manager, or if your window manager keeps the command tool on top
5198
anyway, set this resource to <code>off</code>.
5199
</td></tr>
5200
</table>
4497
anyway, set this resource to ‘<samp><span class="samp">off</span></samp>’.
4498
</p></blockquote></div>
5201
4499
5202
<p>
5203
<table width="100%">
5204
<tr>
5205
<td align="left"><b>stickyTool</b><i> </i>(<i>class StickyTool</i>)<i>
5206
</i></td>
5207
<td align="right">Resource</td>
5208
</tr>
5209
</table>
5210
<table width="95%" align="center">
5211
<tr><td>
5212
If <code>on</code> (default), the command tool automatically follows every
4500
<div class="defun">
4501
— Resource: <b>stickyTool</b> (<var>class StickyTool</var>)<var><a name="index-stickyTool-502"></a></var><br>
4502
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), the command tool automatically follows every
5213
4503
movement of the source window. Whenever the source window is moved, the
5214
4504
command tool is moved by the same offset such that its position relative
5215
to the source window remains unchanged. If <code>off</code>, the command tool
4505
to the source window remains unchanged. If ‘<samp><span class="samp">off</span></samp>’, the command tool
5216
4506
does not follow source window movements.
5217
</td></tr>
5218
</table>
4507
</p></blockquote></div>
5219
4508
5220
<p>
5221
<table width="100%">
5222
<tr>
5223
<td align="left"><b>toolRightOffset</b><i> </i>(<i>class Offset</i>)<i>
5224
</i></td>
5225
<td align="right">Resource</td>
5226
</tr>
5227
</table>
5228
<table width="95%" align="center">
5229
<tr><td>
5230
The distance between the right border of the command tool and the
4509
<div class="defun">
4510
— Resource: <b>toolRightOffset</b> (<var>class Offset</var>)<var><a name="index-toolRightOffset-503"></a></var><br>
4511
<blockquote><p>The distance between the right border of the command tool and the
5231
4512
right border of the source text (in pixels). Default is 8.
5232
</td></tr>
5233
</table>
4513
</p></blockquote></div>
5234
4514
5235
<p>
5236
<table width="100%">
5237
<tr>
5238
<td align="left"><b>toolTopOffset</b><i> </i>(<i>class Offset</i>)<i>
5239
</i></td>
5240
<td align="right">Resource</td>
5241
</tr>
5242
</table>
5243
<table width="95%" align="center">
5244
<tr><td>
5245
The distance between the upper border of the command tool and the
4515
<div class="defun">
4516
— Resource: <b>toolTopOffset</b> (<var>class Offset</var>)<var><a name="index-toolTopOffset-504"></a></var><br>
4517
<blockquote><p>The distance between the upper border of the command tool and the
5246
4518
upper border of the source text (in pixels). Default is 8.
5247
</td></tr>
5248
</table>
4519
</p></blockquote></div>
5249
4520
5250
4521
<ul class="menu">
5251
<li><a accesskey="1" href="#Customizing%20Tool%20Decoration">Customizing Tool Decoration</a>:
4522
<li><a accesskey="1" href="#Customizing-Tool-Decoration">Customizing Tool Decoration</a>
5252
4523
</ul>
5253
4524
5254
4525
<div class="node">
5255
4526
<p><hr>
5256
<small class=header>
5257
Node:<a name="Customizing%20Tool%20Decoration">Customizing Tool Decoration</a>,
5258
Up:<a rel="up" accesskey="u" href="#Customizing%20Tool%20Position">Customizing Tool Position</a>
4527
<a name="Customizing-Tool-Decoration"></a>
4528
Up: <a rel="up" accesskey="u" href="#Customizing-Tool-Position">Customizing Tool Position</a>
5259
4529
</small>
5260
4530
5261
<br>
4531
5262
4532
</div>
5263
4533
5264
<h5 class="subsubsection">Customizing Tool Decoration</h5>
4534
<h5 class="subsubsection">3.3.2.1 Customizing Tool Decoration</h5>
5265
4535
5266
<p>The following resources control the decoration of the command tool
4536
<p>The following resources control the decoration of the command tool
5267
4537
(see <a href="#Customizing">Customizing</a>):
5268
4538
5269
<p>
5270
<table width="100%">
5271
<tr>
5272
<td align="left"><b>decorateTool</b><i> </i>(<i>class Decorate</i>)<i>
5273
</i></td>
5274
<td align="right">Resource</td>
5275
</tr>
5276
</table>
5277
<table width="95%" align="center">
5278
<tr><td>
5279
This resource controls the decoration of the command tool.
4539
<div class="defun">
4540
— Resource: <b>decorateTool</b> (<var>class Decorate</var>)<var><a name="index-decorateTool-505"></a></var><br>
4541
<blockquote><p>This resource controls the decoration of the command tool.
5280
4542
5281
4543
<ul>
5282
<li>If this is <code>off</code>, the command tool is created as a <em>transient
4544
<li>If this is ‘<samp><span class="samp">off</span></samp>’, the command tool is created as a <em>transient
5283
4545
window</em>. Several window managers keep transient windows automatically
5284
4546
on top of their parents, which is appropriate for the command tool.
5285
4547
However, your window manager may be configured not to decorate transient
5286
4548
windows, which means that you cannot easily move the command tool
5287
4549
around.
5288
4550
5289
<li>If this is <code>on</code>, <small>DDD</small> realizes the command tool as a
4551
<li>If this is ‘<samp><span class="samp">on</span></samp>’, <acronym>DDD</acronym> realizes the command tool as a
5290
4552
<em>top-level window</em>. Such windows are always decorated by the
5291
4553
window manager. However, top-level windows are not automatically kept
5292
4554
on top of other windows, such that you may wish to set the
5293
<code>autoRaiseTool</code> resource, too.
4555
‘<samp><span class="samp">autoRaiseTool</span></samp>’ resource, too.
5294
4556
5295
<li>If this is <code>auto</code> (default), <small>DDD</small> checks whether the window
4557
<li>If this is ‘<samp><span class="samp">auto</span></samp>’ (default), <acronym>DDD</acronym> checks whether the window
5296
4558
manager decorates transients. If yes, the command tool is realized as a
5297
transient window (as in the <code>off</code> setting); if no, the command tool
5298
is realized as a top-level window (as in the <code>on</code> setting). Hence,
5299
the command tool is always decorated using the "best" method, but the
4559
transient window (as in the ‘<samp><span class="samp">off</span></samp>’ setting); if no, the command tool
4560
is realized as a top-level window (as in the ‘<samp><span class="samp">on</span></samp>’ setting). Hence,
4561
the command tool is always decorated using the “best” method, but the
5300
4562
extra check takes some time.
5301
4563
</ul>
5302
</td></tr>
5303
</table>
4564
</p></blockquote></div>
5304
4565
5305
4566
<div class="node">
5306
4567
<p><hr>
5307
<small class=header>
5308
Node:<a name="Getting%20Help">Getting Help</a>,
5309
Next:<a rel="next" accesskey="n" href="#Undo%20and%20Redo">Undo and Redo</a>,
5310
Previous:<a rel="previous" accesskey="p" href="#Command%20Tool">Command Tool</a>,
5311
Up:<a rel="up" accesskey="u" href="#Windows">Windows</a>
4568
<a name="Getting-Help"></a>
4569
Next: <a rel="next" accesskey="n" href="#Undo-and-Redo">Undo and Redo</a>,
4570
Previous: <a rel="previous" accesskey="p" href="#Command-Tool">Command Tool</a>,
4571
Up: <a rel="up" accesskey="u" href="#Windows">Windows</a>
5312
4572
</small>
5313
4573
5314
<br>
4574
5315
4575
</div>
5316
4576
5317
<h3 class="section">Getting Help</h3>
4577
<h3 class="section">3.4 Getting Help</h3>
5318
4578
5319
<p><small>DDD</small> has an extensive on-line help system. Here's how to get
5320
help while working with <small>DDD</small>.
4579
<p><a name="index-Help-506"></a>
4580
<acronym>DDD</acronym> has an extensive on-line help system. Here's how to get
4581
help while working with <acronym>DDD</acronym>.
5321
4582
5322
4583
<ul>
5323
<li>You can get a short help text on most <small>DDD</small> buttons by simply
4584
<li><a name="index-Button-tip-507"></a><a name="index-Tool-tip-508"></a><a name="index-Balloon-help-509"></a><a name="index-Help_002c-on-buttons-510"></a><a name="index-Tip_002c-on-buttons-511"></a>You can get a short help text on most <acronym>DDD</acronym> buttons by simply
5324
4585
moving the mouse pointer on it and leave it there. After a second, a
5325
4586
small window (called <dfn>button tip</dfn>; also known as <dfn>tool tip</dfn> or
5326
4587
<dfn>balloon help</dfn>) pops up, giving a hint on the button's meaning. The
5327
4588
button tip disappears as soon as you move the mouse pointer to another
5328
4589
item.
5329
4590
5330
<li>The <dfn>status line</dfn> also displays information about the currently selected
4591
<li><a name="index-Help_002c-in-the-status-line-512"></a><a name="index-Status-line-513"></a>The <dfn>status line</dfn> also displays information about the currently selected
5331
4592
item. By clicking on the status line, you can redisplay the most
5332
4593
recent messages.
5333
4594
5334
<li>You can get detailed help on any visible <small>DDD</small> item. Just
5335
point on the item you want help and press the <code>F1</code> key. This
4595
<li><a name="index-Help_002c-on-items-514"></a><a name="index-Context_002dsensitive-help-515"></a><a name="index-F1-516"></a>You can get detailed help on any visible <acronym>DDD</acronym> item. Just
4596
point on the item you want help and press the ‘<samp><span class="samp">F1</span></samp>’ key. This
5336
4597
pops up a detailed help text.
5337
4598
5338
<li>The <small>DDD</small> dialogs all contain <code>Help</code> buttons that give
4599
<li><a name="index-Help-517"></a>The <acronym>DDD</acronym> dialogs all contain ‘<samp><span class="samp">Help</span></samp>’ buttons that give
5339
4600
detailed information about the dialog.
5340
4601
5341
<li>You can get help on debugger commands by entering <code>help</code> at the
5342
debugger prompt. See <a href="#Entering%20Commands">Entering Commands</a>, for details on entering
4602
<li><a name="index-Help_002c-on-commands-518"></a><a name="index-help-519"></a>You can get help on debugger commands by entering <samp><span class="command">help</span></samp> at the
4603
debugger prompt. See <a href="#Entering-Commands">Entering Commands</a>, for details on entering
5343
4604
commands.
5344
4605
5345
<li>If you are totally stuck, try <code>Help => What Now?</code> (the
5346
<code>What Now?</code> item in the <code>Help</code> menu) or press <Ctrl+F1>.
5347
Depending on the current state, <small>DDD</small> will give you some hints on
4606
<li><a name="index-What-Now_003f-520"></a><a name="index-Ctrl_002bF1-521"></a><a name="index-Help_002c-when-stuck-522"></a>If you are totally stuck, try ‘<samp><span class="samp">Help What Now?</span></samp>’ (the
4607
‘<samp><span class="samp">What Now?</span></samp>’ item in the ‘<samp><span class="samp">Help</span></samp>’ menu) or press <Ctrl+F1>.
4608
Depending on the current state, <acronym>DDD</acronym> will give you some hints on
5348
4609
what you can do next.
5349
4610
5350
4611
<li>Of course, you can always refer to the <em>on-line documentation</em>:
5351
4612
5352
4613
<ul>
5353
<li><code>Help => </code><small>DDD</small><code> Reference</code> gives you access to the
5354
<small>DDD</small> manual, the ultimate <small>DDD</small> reference.
4614
<li><a name="index-g_t_0040value_007bDDD_007d-Reference-523"></a>‘<samp><span class="samp">Help <acronym>DDD</acronym> Reference</span></samp>’ gives you access to the
4615
<acronym>DDD</acronym> manual, the ultimate <acronym>DDD</acronym> reference.
5355
4616
5356
<li><code>Help => Debugger Reference</code> shows you the
4617
<li><a name="index-Debugger-Reference-524"></a><a name="index-GDB-Reference-525"></a><a name="index-DBX-Reference-526"></a><a name="index-Ladebug-Reference-527"></a><a name="index-XDB-Reference-528"></a><a name="index-JDB-Reference-529"></a><a name="index-PYDB-Reference-530"></a><a name="index-Perl-Reference-531"></a><a name="index-Bash-Reference-532"></a>‘<samp><span class="samp">Help Debugger Reference</span></samp>’ shows you the
5357
4618
on-line documentation of the inferior debugger.
5358
4619
5359
<li><code>Help => </code><small>DDD</small><code> </code><small>WWW</small><code> Page</code> gives you access to the
5360
latest and greatest information on <small>DDD</small>.
5361
</ul>
4620
<li>‘<samp><span class="samp">Help <acronym>DDD</acronym> <acronym>WWW</acronym> Page</span></samp>’ gives you access to the
4621
latest and greatest information on <acronym>DDD</acronym>.
4622
<a name="index-g_t_0040value_007bDDD_007d-_0040WWW_007b_007d-Page-533"></a></ul>
5362
4623
5363
<li>Finally, the <small>DDD</small> <dfn>Tip Of The Day</dfn> gives you important hints
5364
with each new <small>DDD</small> invocation.
5365
</ul>
4624
<li>Finally, the <acronym>DDD</acronym> <dfn>Tip Of The Day</dfn> gives you important hints
4625
with each new <acronym>DDD</acronym> invocation.
4626
<a name="index-Tip-of-the-day-534"></a></ul>
5366
4627
5367
4628
<p>All these functions can be customized in various ways
5368
(see <a href="#Customizing%20Help">Customizing Help</a>).
4629
(see <a href="#Customizing-Help">Customizing Help</a>).
5369
4630
5370
<p>If, after all, you made a mistake, don't worry: almost every <small>DDD</small>
5371
command can be undone. See <a href="#Undo%20and%20Redo">Undo and Redo</a>, for details.
4631
<p>If, after all, you made a mistake, don't worry: almost every <acronym>DDD</acronym>
4632
command can be undone. See <a href="#Undo-and-Redo">Undo and Redo</a>, for details.
5372
4633
5373
4634
<div class="node">
5374
4635
<p><hr>
5375
<small class=header>
5376
Node:<a name="Undo%20and%20Redo">Undo and Redo</a>,
5377
Next:<a rel="next" accesskey="n" href="#Customizing">Customizing</a>,
5378
Previous:<a rel="previous" accesskey="p" href="#Getting%20Help">Getting Help</a>,
5379
Up:<a rel="up" accesskey="u" href="#Windows">Windows</a>
4636
<a name="Undo-and-Redo"></a>
4637
Next: <a rel="next" accesskey="n" href="#Customizing">Customizing</a>,
4638
Previous: <a rel="previous" accesskey="p" href="#Getting-Help">Getting Help</a>,
4639
Up: <a rel="up" accesskey="u" href="#Windows">Windows</a>
5380
4640
</small>
5381
4641
5382
<br>
4642
5383
4643
</div>
5384
4644
5385
<h3 class="section">Undoing and Redoing Commands</h3>
5386
5387
<p>Almost every <small>DDD</small> command can be undone, using <code>Edit
5388
=> Undo</code> or the <code>Undo</code> button on the command tool.
5389
5390
<p>Likewise, <code>Edit => Redo</code> repeats the command most recently
4645
<h3 class="section">3.5 Undoing and Redoing Commands</h3>
4646
4647
<p><a name="index-Undo-535"></a><a name="index-Undoing-commands-536"></a>
4648
Almost every <acronym>DDD</acronym> command can be undone, using ‘<samp><span class="samp">Edit
4649
Undo</span></samp>’ or the ‘<samp><span class="samp">Undo</span></samp>’ button on the command tool.
4650
4651
<p><a name="index-Redo-537"></a><a name="index-Redoing-commands-538"></a>Likewise, ‘<samp><span class="samp">Edit Redo</span></samp>’ repeats the command most recently
5391
4652
undone.
5392
4653
5393
<p>The <code>Edit</code> menu shows which commands are to be undone and redone
5394
next; this is also indicated by the popup help on the <code>Undo</code> and
5395
<code>Redo</code> buttons.
4654
<p>The ‘<samp><span class="samp">Edit</span></samp>’ menu shows which commands are to be undone and redone
4655
next; this is also indicated by the popup help on the ‘<samp><span class="samp">Undo</span></samp>’ and
4656
‘<samp><span class="samp">Redo</span></samp>’ buttons.
5396
4657
5397
4658
<div class="node">
5398
4659
<p><hr>
5399
<small class=header>
5400
Node:<a name="Customizing">Customizing</a>,
5401
Previous:<a rel="previous" accesskey="p" href="#Undo%20and%20Redo">Undo and Redo</a>,
5402
Up:<a rel="up" accesskey="u" href="#Windows">Windows</a>
4660
<a name="Customizing"></a>
4661
Previous: <a rel="previous" accesskey="p" href="#Undo-and-Redo">Undo and Redo</a>,
4662
Up: <a rel="up" accesskey="u" href="#Windows">Windows</a>
5403
4663
</small>
5404
4664
5405
<br>
4665
5406
4666
</div>
5407
4667
5408
<h3 class="section">Customizing DDD</h3>
4668
<h3 class="section">3.6 Customizing DDD</h3>
5409
4669
5410
<p><small>DDD</small> is controlled by several <em>resources</em>--user-defined
4670
<p><acronym>DDD</acronym> is controlled by several <em>resources</em>—user-defined
5411
4671
variables that take specific values in order to control and customize
5412
<small>DDD</small> behavior.
4672
<acronym>DDD</acronym> behavior.
5413
4673
5414
<p>Most <small>DDD</small> resources can be set interactively while <small>DDD</small> is
5415
running or when invoking <small>DDD</small>. See <a href="#Resource%20Index">Resource Index</a>, for the full list
5416
of <small>DDD</small> resources.
4674
<p>Most <acronym>DDD</acronym> resources can be set interactively while <acronym>DDD</acronym> is
4675
running or when invoking <acronym>DDD</acronym>. See <a href="#Resource-Index">Resource Index</a>, for the full list
4676
of <acronym>DDD</acronym> resources.
5417
4677
5418
4678
<p>We first discuss how customizing works in general; then we turn to
5419
customizing parts of <small>DDD</small> introduced so far.
5420
5421
<ul class="menu">
5422
<li><a accesskey="1" href="#How%20Customizing%20Works">How Customizing Works</a>:
5423
<li><a accesskey="2" href="#Customizing%20Help">Customizing Help</a>:
5424
<li><a accesskey="3" href="#Customizing%20Undo">Customizing Undo</a>:
5425
<li><a accesskey="4" href="#Customizing%20Windows">Customizing Windows</a>:
5426
<li><a accesskey="5" href="#Debugger%20Settings">Debugger Settings</a>:
5427
</ul>
5428
5429
<div class="node">
5430
<p><hr>
5431
<small class=header>
5432
Node:<a name="How%20Customizing%20Works">How Customizing Works</a>,
5433
Next:<a rel="next" accesskey="n" href="#Customizing%20Help">Customizing Help</a>,
5434
Up:<a rel="up" accesskey="u" href="#Customizing">Customizing</a>
5435
</small>
5436
5437
<br>
5438
</div>
5439
5440
<h4 class="subsection">How Customizing DDD Works</h4>
5441
5442
<ul class="menu">
5443
<li><a accesskey="1" href="#Resources">Resources</a>:
5444
<li><a accesskey="2" href="#Changing%20Resources">Changing Resources</a>:
5445
<li><a accesskey="3" href="#Saving%20Options">Saving Options</a>:
5446
</ul>
5447
5448
<div class="node">
5449
<p><hr>
5450
<small class=header>
5451
Node:<a name="Resources">Resources</a>,
5452
Next:<a rel="next" accesskey="n" href="#Changing%20Resources">Changing Resources</a>,
5453
Up:<a rel="up" accesskey="u" href="#How%20Customizing%20Works">How Customizing Works</a>
5454
</small>
5455
5456
<br>
5457
</div>
5458
5459
<h5 class="subsubsection">Resources</h5>
5460
5461
<p>Just like any X program, <small>DDD</small> has a number of places to get
5462
resource values from. For <small>DDD</small>, the most important places to
4679
customizing parts of <acronym>DDD</acronym> introduced so far.
4680
4681
<ul class="menu">
4682
<li><a accesskey="1" href="#How-Customizing-Works">How Customizing Works</a>
4683
<li><a accesskey="2" href="#Customizing-Help">Customizing Help</a>
4684
<li><a accesskey="3" href="#Customizing-Undo">Customizing Undo</a>
4685
<li><a accesskey="4" href="#Customizing-Windows">Customizing Windows</a>
4686
<li><a accesskey="5" href="#Debugger-Settings">Debugger Settings</a>
4687
</ul>
4688
4689
<div class="node">
4690
<p><hr>
4691
<a name="How-Customizing-Works"></a>
4692
Next: <a rel="next" accesskey="n" href="#Customizing-Help">Customizing Help</a>,
4693
Up: <a rel="up" accesskey="u" href="#Customizing">Customizing</a>
4694
</small>
4695
4696
4697
</div>
4698
4699
<h4 class="subsection">3.6.1 How Customizing DDD Works</h4>
4700
4701
<ul class="menu">
4702
<li><a accesskey="1" href="#Resources">Resources</a>
4703
<li><a accesskey="2" href="#Changing-Resources">Changing Resources</a>
4704
<li><a accesskey="3" href="#Saving-Options">Saving Options</a>
4705
</ul>
4706
4707
<div class="node">
4708
<p><hr>
4709
<a name="Resources"></a>
4710
Next: <a rel="next" accesskey="n" href="#Changing-Resources">Changing Resources</a>,
4711
Up: <a rel="up" accesskey="u" href="#How-Customizing-Works">How Customizing Works</a>
4712
</small>
4713
4714
4715
</div>
4716
4717
<h5 class="subsubsection">3.6.1.1 Resources</h5>
4718
4719
<p><a name="index-Resources-539"></a>
4720
Just like any X program, <acronym>DDD</acronym> has a number of places to get
4721
resource values from. For <acronym>DDD</acronym>, the most important places to
5463
4722
specify resources are:
5464
4723
5465
4724
<ul>
5466
<li>The <code>~/.ddd/init</code> file (<code>~</code> stands for your home
5467
directory). This file is read in by <small>DDD</small> upon start-up; the
4725
<li><a name="index-init-540"></a><a name="index-g_t_007e-541"></a>The <samp><span class="file">~/.ddd/init</span></samp> file (<samp><span class="file">~</span></samp> stands for your home
4726
directory). This file is read in by <acronym>DDD</acronym> upon start-up; the
5468
4727
resources specified herein override all other sources (except for
5469
4728
resources given implicitly by command-line options).
5470
4729
5471
<p>If the environment variable <code>DDD_STATE</code> is set, its value
5472
is used instead of <code>~/.ddd/</code>.
4730
<p><a name="index-DDD_005fSTATE-542"></a>If the environment variable <samp><span class="env">DDD_STATE</span></samp> is set, its value
4731
is used instead of <samp><span class="file">~/.ddd/</span></samp>.
5473
4732
5474
</p><li>The <code>Ddd</code> application-defaults file. This file is
5475
typically compiled into the <small>DDD</small> executable. If it exists, its
5476
resource values override the values compiled into <small>DDD</small>. If the
5477
versions of the <code>Ddd</code> application-defaults file and the
5478
<small>DDD</small> executable do not match, <small>DDD</small> may not function
5479
properly; <small>DDD</small> will give you a warning in this case.<a rel="footnote" href="#fn-8"><sup>8</sup></a>
4733
<li><a name="index-Ddd-543"></a>The <samp><span class="file">Ddd</span></samp> application-defaults file. This file is
4734
typically compiled into the <acronym>DDD</acronym> executable. If it exists, its
4735
resource values override the values compiled into <acronym>DDD</acronym>. If the
4736
versions of the <samp><span class="file">Ddd</span></samp> application-defaults file and the
4737
<acronym>DDD</acronym> executable do not match, <acronym>DDD</acronym> may not function
4738
properly; <acronym>DDD</acronym> will give you a warning in this case.<a rel="footnote" href="#fn-8" name="fnd-8"><sup>8</sup></a>
5480
4739
5481
4740
<li>The command-line options. These options override all other resource
5482
4741
settings.
5483
4742
5484
<li>If the environment variable <code>DDD_SESSION</code> is set, it
4743
<li><a name="index-DDD_005fSESSION-544"></a>If the environment variable <samp><span class="env">DDD_SESSION</span></samp> is set, it
5485
4744
indicates the name of a session to start, overriding all options and
5486
resources. This is used by <small>DDD</small> when restarting itself.
4745
resources. This is used by <acronym>DDD</acronym> when restarting itself.
5487
4746
</ul>
5488
4747
5489
4748
<p>Not every resource has a matching command-line option. Each resource
5490
(whether in <code>~/.ddd/init</code> or <code>Ddd</code>) is
4749
(whether in <samp><span class="file">~/.ddd/init</span></samp> or <samp><span class="file">Ddd</span></samp>) is
5491
4750
specified using a line
5492
4751
5493
4752
<pre class="example"> Ddd*<var>resource</var>: <var>value</var>
5494
</pre>
5495
5496
<p>For instance, to set the <code>pollChildStatus</code> resource to <code>off</code>,
5497
you would specify in <code>~/.ddd/init</code>:
4753
</pre>
4754
<p>For instance, to set the ‘<samp><span class="samp">pollChildStatus</span></samp>’ resource to ‘<samp><span class="samp">off</span></samp>’,
4755
you would specify in <samp><span class="file">~/.ddd/init</span></samp>:
5498
4756
5499
4757
<pre class="example"> Ddd*pollChildStatus: off
5500
</pre>
5501
4758
</pre>
5502
4759
<p>For more details on the syntax of resource specifications, see the
5503
4760
section <cite>RESOURCES</cite> in the <cite>X(1)</cite> manual page.
5504
4761
5505
4762
<div class="node">
5506
4763
<p><hr>
5507
<small class=header>
5508
Node:<a name="Changing%20Resources">Changing Resources</a>,
5509
Next:<a rel="next" accesskey="n" href="#Saving%20Options">Saving Options</a>,
5510
Previous:<a rel="previous" accesskey="p" href="#Resources">Resources</a>,
5511
Up:<a rel="up" accesskey="u" href="#How%20Customizing%20Works">How Customizing Works</a>
4764
<a name="Changing-Resources"></a>
4765
Next: <a rel="next" accesskey="n" href="#Saving-Options">Saving Options</a>,
4766
Previous: <a rel="previous" accesskey="p" href="#Resources">Resources</a>,
4767
Up: <a rel="up" accesskey="u" href="#How-Customizing-Works">How Customizing Works</a>
5512
4768
</small>
5513
4769
5514
<br>
4770
5515
4771
</div>
5516
4772
5517
<h5 class="subsubsection">Changing Resources</h5>
4773
<h5 class="subsubsection">3.6.1.2 Changing Resources</h5>
5518
4774
5519
<p>You can change <small>DDD</small> resources by three methods:
4775
<p>You can change <acronym>DDD</acronym> resources by three methods:
5520
4776
5521
4777
<ul>
5522
<li>Use <small>DDD</small> to change the options, notably <code>Edit =>
5523
Preferences</code>. This works for the most important <small>DDD</small> resources.
5524
Be sure to save the options (see <a href="#Saving%20Options">Saving Options</a>) such that they
5525
apply to future <small>DDD</small> sessions, too.
4778
<li>Use <acronym>DDD</acronym> to change the options, notably ‘<samp><span class="samp">Edit
4779
Preferences</span></samp>’. This works for the most important <acronym>DDD</acronym> resources.
4780
Be sure to save the options (see <a href="#Saving-Options">Saving Options</a>) such that they
4781
apply to future <acronym>DDD</acronym> sessions, too.
5526
4782
5527
<li>You can also invoke <small>DDD</small> with an appropriate command-line option.
5528
This changes the related <small>DDD</small> resource for this particular
5529
<small>DDD</small> invocation. However, if you save the options (see <a href="#Saving%20Options">Saving Options</a>), the changed resource will also apply to future invocations.
4783
<li>You can also invoke <acronym>DDD</acronym> with an appropriate command-line option.
4784
This changes the related <acronym>DDD</acronym> resource for this particular
4785
<acronym>DDD</acronym> invocation. However, if you save the options (see <a href="#Saving-Options">Saving Options</a>), the changed resource will also apply to future invocations.
5530
4786
5531
4787
<li>Finally, you can set the appropriate resource in a file named
5532
<code>.ddd/init</code> in your home directory.
5533
See <a href="#Resource%20Index">Resource Index</a>, for a list of <small>DDD</small> resources to be set.
4788
<samp><span class="file">.ddd/init</span></samp> in your home directory.
4789
See <a href="#Resource-Index">Resource Index</a>, for a list of <acronym>DDD</acronym> resources to be set.
5534
4790
</ul>
5535
4791
5536
4792
<div class="node">
5537
4793
<p><hr>
5538
<small class=header>
5539
Node:<a name="Saving%20Options">Saving Options</a>,
5540
Previous:<a rel="previous" accesskey="p" href="#Changing%20Resources">Changing Resources</a>,
5541
Up:<a rel="up" accesskey="u" href="#How%20Customizing%20Works">How Customizing Works</a>
4794
<a name="Saving-Options"></a>
4795
Previous: <a rel="previous" accesskey="p" href="#Changing-Resources">Changing Resources</a>,
4796
Up: <a rel="up" accesskey="u" href="#How-Customizing-Works">How Customizing Works</a>
5542
4797
</small>
5543
4798
5544
<br>
4799
5545
4800
</div>
5546
4801
5547
<h5 class="subsubsection">Saving Options</h5>
4802
<h5 class="subsubsection">3.6.1.3 Saving Options</h5>
5548
4803
5549
<p>You can save the current option settings by setting <code>Edit =>
5550
Save Options</code>. Options are saved in a file named
5551
<code>.ddd/init</code> in your home directory when <small>DDD</small> exits. If a
4804
<p>You can save the current option settings by setting ‘<samp><span class="samp">Edit
4805
Save Options</span></samp>’. Options are saved in a file named
4806
<samp><span class="file">.ddd/init</span></samp> in your home directory when <acronym>DDD</acronym> exits. If a
5552
4807
session <var>session</var> is active, options will be saved in
5553
<code>~/.ddd/sessions/</code><var>session</var><code>/init</code> instead.
4808
<samp><span class="file">~/.ddd/sessions/</span><var>session</var><span class="file">/init</span></samp> instead.
5554
4809
5555
<p>The options are automatically saved when exiting <small>DDD</small>. You can turn
5556
off this feature by unsetting <code>Edit => Save Options</code>. This
4810
<p>The options are automatically saved when exiting <acronym>DDD</acronym>. You can turn
4811
off this feature by unsetting ‘<samp><span class="samp">Edit Save Options</span></samp>’. This
5557
4812
is tied to the following resource:
5558
4813
5559
<p>
5560
<table width="100%">
5561
<tr>
5562
<td align="left"><b>saveOptionsOnExit</b><i> </i>(<i>class SaveOnExit</i>)<i>
5563
</i></td>
5564
<td align="right">Resource</td>
5565
</tr>
5566
</table>
5567
<table width="95%" align="center">
5568
<tr><td>
5569
If <code>on</code> (default), the current option settings are automatically saved
5570
when <small>DDD</small> exits.
5571
</td></tr>
5572
</table>
4814
<div class="defun">
4815
— Resource: <b>saveOptionsOnExit</b> (<var>class SaveOnExit</var>)<var><a name="index-saveOptionsOnExit-545"></a></var><br>
4816
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), the current option settings are automatically saved
4817
when <acronym>DDD</acronym> exits.
4818
</p></blockquote></div>
5573
4819
5574
4820
<div class="node">
5575
4821
<p><hr>
5576
<small class=header>
5577
Node:<a name="Customizing%20Help">Customizing Help</a>,
5578
Next:<a rel="next" accesskey="n" href="#Customizing%20Undo">Customizing Undo</a>,
5579
Previous:<a rel="previous" accesskey="p" href="#How%20Customizing%20Works">How Customizing Works</a>,
5580
Up:<a rel="up" accesskey="u" href="#Customizing">Customizing</a>
4822
<a name="Customizing-Help"></a>
4823
Next: <a rel="next" accesskey="n" href="#Customizing-Undo">Customizing Undo</a>,
4824
Previous: <a rel="previous" accesskey="p" href="#How-Customizing-Works">How Customizing Works</a>,
4825
Up: <a rel="up" accesskey="u" href="#Customizing">Customizing</a>
5581
4826
</small>
5582
4827
5583
<br>
4828
5584
4829
</div>
5585
4830
5586
<h4 class="subsection">Customizing DDD Help</h4>
4831
<h4 class="subsection">3.6.2 Customizing DDD Help</h4>
5587
4832
5588
<p><small>DDD</small> Help can be customized in various ways.
4833
<p><acronym>DDD</acronym> Help can be customized in various ways.
5589
4834
5590
4835
<ul class="menu">
5591
<li><a accesskey="1" href="#Button%20tips">Button tips</a>: Turning off tips.
5592
<li><a accesskey="2" href="#Tip%20of%20the%20day">Tip of the day</a>: Turning off the tip of the day.
5593
<li><a accesskey="3" href="#Help%20Helpers">Help Helpers</a>: Helper programs invoked by Help.
4836
<li><a accesskey="1" href="#Button-tips">Button tips</a>: Turning off tips.
4837
<li><a accesskey="2" href="#Tip-of-the-day">Tip of the day</a>: Turning off the tip of the day.
4838
<li><a accesskey="3" href="#Help-Helpers">Help Helpers</a>: Helper programs invoked by Help.
5594
4839
</ul>
5595
4840
5596
4841
<div class="node">
5597
4842
<p><hr>
5598
<small class=header>
5599
Node:<a name="Button%20tips">Button tips</a>,
5600
Next:<a rel="next" accesskey="n" href="#Tip%20of%20the%20day">Tip of the day</a>,
5601
Up:<a rel="up" accesskey="u" href="#Customizing%20Help">Customizing Help</a>
4843
<a name="Button-tips"></a>
4844
Next: <a rel="next" accesskey="n" href="#Tip-of-the-day">Tip of the day</a>,
4845
Up: <a rel="up" accesskey="u" href="#Customizing-Help">Customizing Help</a>
5602
4846
</small>
5603
4847
5604
<br>
4848
5605
4849
</div>
5606
4850
5607
<h5 class="subsubsection">Button Tips</h5>
4851
<h5 class="subsubsection">3.6.2.1 Button Tips</h5>
5608
4852
5609
<p>Button tips are helpful for novices, but may be distracting for
5610
experienced users. You can turn off button tips via <code>Edit
5611
=> Preferences => General => Automatic display of
5612
Button Hints => as Popup Tips</code>.
4853
<p><a name="index-Automatic-Display-of-Button-Hints-546"></a><a name="index-Button-tip_002c-turning-off-547"></a>Button tips are helpful for novices, but may be distracting for
4854
experienced users. You can turn off button tips via ‘<samp><span class="samp">Edit
4855
Preferences General Automatic display of
4856
Button Hints as Popup Tips</span></samp>’.
5613
4857
5614
4858
<p>You can also turn off the hint that is displayed in the status line.
5615
Just toggle <code>Edit => Preferences => General =>
5616
Automatic Display of Button Hints => in the Status Line</code>.
5617
5618
<br><p>
4859
Just toggle ‘<samp><span class="samp">Edit Preferences General
4860
Automatic Display of Button Hints in the Status Line</span></samp>’.
4861
4862
<pre class="sp">
4863
4864
</pre>
5619
4865
<div align="center"><img src="PICS/ddd-general-prefs.jpg" alt="PICS/ddd-general-prefs.jpg"></div>
5620
<br><p>
5621
<p>These are the related <small>DDD</small> resources (see <a href="#Customizing">Customizing</a>):
5622
5623
<p>
5624
<table width="100%">
5625
<tr>
5626
<td align="left"><b>buttonTips</b><i> </i>(<i>class Tips</i>)<i>
5627
</i></td>
5628
<td align="right">Resource</td>
5629
</tr>
5630
</table>
5631
<table width="95%" align="center">
5632
<tr><td>
5633
If <code>on</code> (default), enable button tips.
5634
</td></tr>
5635
</table>
5636
5637
<p>
5638
<table width="100%">
5639
<tr>
5640
<td align="left"><b>buttonDocs</b><i> </i>(<i>class Docs</i>)<i>
5641
</i></td>
5642
<td align="right">Resource</td>
5643
</tr>
5644
</table>
5645
<table width="95%" align="center">
5646
<tr><td>
5647
If <code>on</code> (default), show button hints in the status line.
5648
</td></tr>
5649
</table>
4866
<pre class="sp">
4867
4868
</pre>
4869
4870
These are the related <acronym>DDD</acronym> resources (see <a href="#Customizing">Customizing</a>):
4871
4872
<div class="defun">
4873
— Resource: <b>buttonTips</b> (<var>class Tips</var>)<var><a name="index-buttonTips-548"></a></var><br>
4874
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), enable button tips.
4875
</p></blockquote></div>
4876
4877
<div class="defun">
4878
— Resource: <b>buttonDocs</b> (<var>class Docs</var>)<var><a name="index-buttonDocs-549"></a></var><br>
4879
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), show button hints in the status line.
4880
</p></blockquote></div>
5650
4881
5651
4882
<div class="node">
5652
4883
<p><hr>
5653
<small class=header>
5654
Node:<a name="Tip%20of%20the%20day">Tip of the day</a>,
5655
Next:<a rel="next" accesskey="n" href="#Help%20Helpers">Help Helpers</a>,
5656
Previous:<a rel="previous" accesskey="p" href="#Button%20tips">Button tips</a>,
5657
Up:<a rel="up" accesskey="u" href="#Customizing%20Help">Customizing Help</a>
4884
<a name="Tip-of-the-day"></a>
4885
Next: <a rel="next" accesskey="n" href="#Help-Helpers">Help Helpers</a>,
4886
Previous: <a rel="previous" accesskey="p" href="#Button-tips">Button tips</a>,
4887
Up: <a rel="up" accesskey="u" href="#Customizing-Help">Customizing Help</a>
5658
4888
</small>
5659
4889
5660
<br>
4890
5661
4891
</div>
5662
4892
5663
<h5 class="subsubsection">Tip of the day</h5>
5664
5665
<p>You can turn off the tip of the day by toggling <code>Edit =>
5666
Preferences => Startup => Startup Windows => Tip of
5667
the Day</code>.
5668
5669
<p>Here is the related <small>DDD</small> resource (see <a href="#Customizing">Customizing</a>):
5670
5671
<p>
5672
<table width="100%">
5673
<tr>
5674
<td align="left"><b>startupTips</b><i> </i>(<i>class StartupTips</i>)<i>
5675
</i></td>
5676
<td align="right">Resource</td>
5677
</tr>
5678
</table>
5679
<table width="95%" align="center">
5680
<tr><td>
5681
If <code>on</code> (default), show a tip of the day upon <small>DDD</small> startup.
5682
</td></tr>
5683
</table>
5684
5685
<p>See <a href="#Options">Options</a>, for options to set this resource upon <small>DDD</small>
4893
<h5 class="subsubsection">3.6.2.2 Tip of the day</h5>
4894
4895
<p><a name="index-Tip-of-the-day_002c-turning-off-550"></a>
4896
You can turn off the tip of the day by toggling ‘<samp><span class="samp">Edit
4897
Preferences Startup Startup Windows Tip of
4898
the Day</span></samp>’.
4899
4900
<p>Here is the related <acronym>DDD</acronym> resource (see <a href="#Customizing">Customizing</a>):
4901
4902
<div class="defun">
4903
— Resource: <b>startupTips</b> (<var>class StartupTips</var>)<var><a name="index-startupTips-551"></a></var><br>
4904
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), show a tip of the day upon <acronym>DDD</acronym> startup.
4905
</p></blockquote></div>
4906
4907
<p>See <a href="#Options">Options</a>, for options to set this resource upon <acronym>DDD</acronym>
5686
4908
invocation.
5687
4909
5688
4910
<p>The actual tips are controlled by these resources (see <a href="#Customizing">Customizing</a>):
5689
4911
5690
<p>
5691
<table width="100%">
5692
<tr>
5693
<td align="left"><b>startupTipCount</b><i> </i>(<i>class StartupTipCount</i>)<i>
5694
</i></td>
5695
<td align="right">Resource</td>
5696
</tr>
5697
</table>
5698
<table width="95%" align="center">
5699
<tr><td>
5700
The number <var>n</var> of the tip of the day to be shown at startup. See
5701
also the <code>tip</code><var>n</var><code></code> resources.
5702
</td></tr>
5703
</table>
4912
<div class="defun">
4913
— Resource: <b>startupTipCount</b> (<var>class StartupTipCount</var>)<var><a name="index-startupTipCount-552"></a></var><br>
4914
<blockquote><p>The number <var>n</var> of the tip of the day to be shown at startup. See
4915
also the ‘<samp><span class="samp">tip</span><var>n</var></samp>’ resources.
4916
</p></blockquote></div>
5704
4917
5705
<p>
5706
<table width="100%">
5707
<tr>
5708
<td align="left"><b>tip</b><i></i><var>n</var><i> </i>(<i>class Tip</i>)<i>
5709
</i></td>
5710
<td align="right">Resource</td>
5711
</tr>
5712
</table>
5713
<table width="95%" align="center">
5714
<tr><td>
5715
The tip of the day numbered <var>n</var> (a string).
5716
</td></tr>
5717
</table>
4918
<div class="defun">
4919
— Resource: <b>tip</b><var>n </var>(<var>class Tip</var>)<var><a name="index-tip-553"></a></var><br>
4920
<blockquote><p>The tip of the day numbered <var>n</var> (a string).
4921
</p></blockquote></div>
5718
4922
5719
4923
<div class="node">
5720
4924
<p><hr>
5721
<small class=header>
5722
Node:<a name="Help%20Helpers">Help Helpers</a>,
5723
Previous:<a rel="previous" accesskey="p" href="#Tip%20of%20the%20day">Tip of the day</a>,
5724
Up:<a rel="up" accesskey="u" href="#Customizing%20Help">Customizing Help</a>
4925
<a name="Help-Helpers"></a>
4926
Previous: <a rel="previous" accesskey="p" href="#Tip-of-the-day">Tip of the day</a>,
4927
Up: <a rel="up" accesskey="u" href="#Customizing-Help">Customizing Help</a>
5725
4928
</small>
5726
4929
5727
<br>
4930
5728
4931
</div>
5729
4932
5730
<h5 class="subsubsection">Help Helpers</h5>
5731
5732
<p><small>DDD</small> relies on a number of external commands, specified via
5733
<code>Edit => Preferences => Helpers</code>.
5734
5735
<br><p>
4933
<h5 class="subsubsection">3.6.2.3 Help Helpers</h5>
4934
4935
<p><acronym>DDD</acronym> relies on a number of external commands, specified via
4936
‘<samp><span class="samp">Edit Preferences Helpers</span></samp>’.
4937
4938
<pre class="sp">
4939
4940
</pre>
5736
4941
<div align="center"><img src="PICS/ddd-helpers.jpg" alt="PICS/ddd-helpers.jpg"></div>
5737
<br><p>
5738
<p>To uncompress help texts, you can define a <code>Uncompress</code> command:
5739
5740
<p>
5741
<table width="100%">
5742
<tr>
5743
<td align="left"><b>uncompressCommand</b><i> </i>(<i>class UncompressCommand</i>)<i>
5744
</i></td>
5745
<td align="right">Resource</td>
5746
</tr>
5747
</table>
5748
<table width="95%" align="center">
5749
<tr><td>
5750
The command to uncompress the built-in <small>DDD</small> manual, the
5751
<small>DDD</small> license, and the <small>DDD</small> news. Takes a compressed text
4942
<pre class="sp">
4943
4944
</pre>
4945
4946
<a name="index-Uncompress-554"></a>To uncompress help texts, you can define a ‘<samp><span class="samp">Uncompress</span></samp>’ command:
4947
4948
<div class="defun">
4949
— Resource: <b>uncompressCommand</b> (<var>class UncompressCommand</var>)<var><a name="index-uncompressCommand-555"></a></var><br>
4950
<blockquote><p><a name="index-gzip-556"></a><a name="index-gunzip-557"></a><a name="index-zcat-558"></a>The command to uncompress the built-in <acronym>DDD</acronym> manual, the
4951
<acronym>DDD</acronym> license, and the <acronym>DDD</acronym> news. Takes a compressed text
5752
4952
from standard input and writes the uncompressed text to standard output.
5753
The default value is <code>gzip -d -c</code>; typical values include
5754
<code>zcat</code> and <code>gunzip -c</code>.
5755
</td></tr>
5756
</table>
5757
5758
<p>To view <small>WWW</small> pages, you can define a <code>Web Browser</code> command:
5759
5760
<p>
5761
<table width="100%">
5762
<tr>
5763
<td align="left"><b>wwwCommand</b><i> </i>(<i>class WWWCommand</i>)<i>
5764
</i></td>
5765
<td align="right">Resource</td>
5766
</tr>
5767
</table>
5768
<table width="95%" align="center">
5769
<tr><td>
5770
The command to invoke a <small>WWW</small> browser. The string <code>@URL@</code> is
5771
replaced by the <small>URL</small> to open. Default is to try a running
5772
Netscape first (trying <code>mozilla</code>, then <code>netscape</code>), then
5773
<code>$WWWBROWSER</code>, then to invoke a new Netscape process, then to
5774
let a running Emacs or XEmacs do the job (via <code>gnudoit</code>), then
5775
to invoke Mosaic, then to invoke Lynx in an xterm.
5776
5777
<p>To specify <code>netscape-6.0</code> as browser, use the setting:
4953
The default value is <samp><span class="command">gzip -d -c</span></samp>; typical values include
4954
<samp><span class="command">zcat</span></samp> and <samp><span class="command">gunzip -c</span></samp>.
4955
</p></blockquote></div>
4956
4957
<p><a name="index-Web-Browser-559"></a>To view <acronym>WWW</acronym> pages, you can define a ‘<samp><span class="samp">Web Browser</span></samp>’ command:
4958
4959
<div class="defun">
4960
— Resource: <b>wwwCommand</b> (<var>class WWWCommand</var>)<var><a name="index-wwwCommand-560"></a></var><br>
4961
<blockquote><p><a name="index-WWWBROWSER-561"></a><a name="index-netscape-562"></a><a name="index-mozilla-563"></a><a name="index-emacs-564"></a><a name="index-xemacs-565"></a><a name="index-firefox-566"></a><a name="index-gnudoit-567"></a><a name="index-lynx-568"></a>The command to invoke a <acronym>WWW</acronym> browser. The string ‘<samp><span class="samp">@URL@</span></samp>’ is
4962
replaced by the <acronym>URL</acronym> to open. Default is to try a running
4963
Netscape first (trying <samp><span class="command">mozilla</span></samp>, then <samp><span class="command">netscape</span></samp>), then
4964
<samp><span class="command">$WWWBROWSER</span></samp>, then to invoke a new Netscape process, then to
4965
let a running Emacs or XEmacs do the job (via <samp><span class="command">gnudoit</span></samp>), then
4966
to invoke Firefox, then to invoke Lynx in an xterm.
4967
4968
<p>To specify ‘<samp><span class="samp">netscape-6.0</span></samp>’ as browser, use the setting:
5778
4969
5779
4970
<pre class="example"> Ddd*wwwCommand: \
5780
4971
netscape-6.0 -remote 'openURL(@URL@)' \
5781
4972
|| netscape-6.0 '@URL@'
5782
</pre>
5783
5784
<p>This command first tries to connect to a running <code>netscape-6.0</code>
4973
</pre>
4974
<p>This command first tries to connect to a running <code>netscape-6.0</code>
5785
4975
browser; if this fails, it starts a new <code>netscape-6.0</code> process.
5786
</td></tr>
5787
</table>
5788
5789
<p>This is the default <small>WWW</small> Page shown by <code>Help => </code><small>DDD</small><code>
5790
</code><small>WWW</small><code> Page</code>:
5791
5792
<p>
5793
<table width="100%">
5794
<tr>
5795
<td align="left"><b>wwwPage</b><i> </i>(<i>class </i><small>WWW</small><i>Page</i>)<i>
5796
</i></td>
5797
<td align="right">Resource</td>
5798
</tr>
5799
</table>
5800
<table width="95%" align="center">
5801
<tr><td>
5802
The <small>DDD</small> <small>WWW</small> page. Value:
4976
</p></blockquote></div>
4977
4978
<p>This is the default <acronym>WWW</acronym> Page shown by ‘<samp><span class="samp">Help <acronym>DDD</acronym>
4979
<acronym>WWW</acronym> Page</span></samp>’:
4980
4981
<div class="defun">
4982
— Resource: <b>wwwPage</b> (<var>class <acronym>WWW</acronym>Page</var>)<var><a name="index-wwwPage-569"></a></var><br>
4983
<blockquote><p>The <acronym>DDD</acronym> <acronym>WWW</acronym> page. Value:
5803
4984
<a href="http://www.gnu.org/software/ddd/">http://www.gnu.org/software/ddd/</a>
5804
</td></tr>
5805
</table>
4985
</p></blockquote></div>
5806
4986
5807
4987
<div class="node">
5808
4988
<p><hr>
5809
<small class=header>
5810
Node:<a name="Customizing%20Undo">Customizing Undo</a>,
5811
Next:<a rel="next" accesskey="n" href="#Customizing%20Windows">Customizing Windows</a>,
5812
Previous:<a rel="previous" accesskey="p" href="#Customizing%20Help">Customizing Help</a>,
5813
Up:<a rel="up" accesskey="u" href="#Customizing">Customizing</a>
4989
<a name="Customizing-Undo"></a>
4990
Next: <a rel="next" accesskey="n" href="#Customizing-Windows">Customizing Windows</a>,
4991
Previous: <a rel="previous" accesskey="p" href="#Customizing-Help">Customizing Help</a>,
4992
Up: <a rel="up" accesskey="u" href="#Customizing">Customizing</a>
5814
4993
</small>
5815
4994
5816
<br>
4995
5817
4996
</div>
5818
4997
5819
<h4 class="subsection">Customizing Undo</h4>
5820
5821
<p><small>DDD</small> Undo can be customized in various ways.
5822
5823
<p>To set a maximum size for the undo buffer, set <code>Edit =>
5824
Preferences => General => Undo Buffer Size</code>.
5825
5826
<p>This is related to the <code>maxUndoSize</code> resource:
5827
5828
<p>
5829
<table width="100%">
5830
<tr>
5831
<td align="left"><b>maxUndoSize</b><i> </i>(<i>class MaxUndoSize</i>)<i>
5832
</i></td>
5833
<td align="right">Resource</td>
5834
</tr>
5835
</table>
5836
<table width="95%" align="center">
5837
<tr><td>
5838
The maximum memory usage (in bytes) of the undo buffer. Useful for
5839
limiting <small>DDD</small> memory usage. A negative value means to place no
4998
<h4 class="subsection">3.6.3 Customizing Undo</h4>
4999
5000
<p><acronym>DDD</acronym> Undo can be customized in various ways.
5001
5002
<p><a name="index-Undo-Buffer-Size-570"></a>To set a maximum size for the undo buffer, set ‘<samp><span class="samp">Edit
5003
Preferences General Undo Buffer Size</span></samp>’.
5004
5005
<p>This is related to the ‘<samp><span class="samp">maxUndoSize</span></samp>’ resource:
5006
5007
<div class="defun">
5008
— Resource: <b>maxUndoSize</b> (<var>class MaxUndoSize</var>)<var><a name="index-maxUndoSize-571"></a></var><br>
5009
<blockquote><p>The maximum memory usage (in bytes) of the undo buffer. Useful for
5010
limiting <acronym>DDD</acronym> memory usage. A negative value means to place no
5840
5011
limit. Default is <code>2000000</code>, or 2000 kBytes.
5841
</td></tr>
5842
</table>
5012
</p></blockquote></div>
5843
5013
5844
5014
<p>You can also limit the number of entries in the undo buffer, regardless
5845
5015
of size (see <a href="#Customizing">Customizing</a>):
5846
5016
5847
<p>
5848
<table width="100%">
5849
<tr>
5850
<td align="left"><b>maxUndoDepth</b><i> </i>(<i>class MaxUndoDepth</i>)<i>
5851
</i></td>
5852
<td align="right">Resource</td>
5853
</tr>
5854
</table>
5855
<table width="95%" align="center">
5856
<tr><td>
5857
The maximum number of entries in the undo buffer. This limits the
5017
<div class="defun">
5018
— Resource: <b>maxUndoDepth</b> (<var>class MaxUndoDepth</var>)<var><a name="index-maxUndoDepth-572"></a></var><br>
5019
<blockquote><p>The maximum number of entries in the undo buffer. This limits the
5858
5020
number of actions that can be undone, and the number of states that
5859
can be shown in historic mode. Useful for limiting <small>DDD</small>
5021
can be shown in historic mode. Useful for limiting <acronym>DDD</acronym>
5860
5022
memory usage. A negative value (default) means to place no limit.
5861
</td></tr>
5862
</table>
5023
</p></blockquote></div>
5863
5024
5864
<p>To clear the undo buffer at any time, thus reducing memory usage, use
5865
<code>Edit => Preferences => General => Clear Undo
5866
Buffer</code>
5025
<p><a name="index-Clear-Undo-Buffer-573"></a>To clear the undo buffer at any time, thus reducing memory usage, use
5026
‘<samp><span class="samp">Edit Preferences General Clear Undo
5027
Buffer</span></samp>’
5867
5028
5868
5029
<div class="node">
5869
5030
<p><hr>
5870
<small class=header>
5871
Node:<a name="Customizing%20Windows">Customizing Windows</a>,
5872
Next:<a rel="next" accesskey="n" href="#Debugger%20Settings">Debugger Settings</a>,
5873
Previous:<a rel="previous" accesskey="p" href="#Customizing%20Undo">Customizing Undo</a>,
5874
Up:<a rel="up" accesskey="u" href="#Customizing">Customizing</a>
5031
<a name="Customizing-Windows"></a>
5032
Next: <a rel="next" accesskey="n" href="#Debugger-Settings">Debugger Settings</a>,
5033
Previous: <a rel="previous" accesskey="p" href="#Customizing-Undo">Customizing Undo</a>,
5034
Up: <a rel="up" accesskey="u" href="#Customizing">Customizing</a>
5875
5035
</small>
5876
5036
5877
<br>
5037
5878
5038
</div>
5879
5039
5880
<h4 class="subsection">Customizing the DDD Windows</h4>
5040
<h4 class="subsection">3.6.4 Customizing the DDD Windows</h4>
5881
5041
5882
<p>You can customize the <small>DDD</small> Windows in various ways.
5042
<p>You can customize the <acronym>DDD</acronym> Windows in various ways.
5883
5043
5884
5044
<ul class="menu">
5885
<li><a accesskey="1" href="#Splash%20Screen">Splash Screen</a>: Turning off the splash screen.
5886
<li><a accesskey="2" href="#Window%20Layout">Window Layout</a>: Re-arranging windows.
5887
<li><a accesskey="3" href="#Customizing%20Fonts">Customizing Fonts</a>: Using alternate fonts.
5888
<li><a accesskey="4" href="#Toggling%20Windows">Toggling Windows</a>: Turning off windows.
5889
<li><a accesskey="5" href="#Text%20Fields">Text Fields</a>: Popdown histories.
5890
<li><a accesskey="6" href="#Icons">Icons</a>: Iconifying <small>DDD</small> windows.
5891
<li><a accesskey="7" href="#Adding%20Buttons">Adding Buttons</a>: Create your own button set.
5892
<li><a accesskey="8" href="#More%20Customizations">More Customizations</a>:
5045
<li><a accesskey="1" href="#Splash-Screen">Splash Screen</a>: Turning off the splash screen.
5046
<li><a accesskey="2" href="#Window-Layout">Window Layout</a>: Re-arranging windows.
5047
<li><a accesskey="3" href="#Customizing-Fonts">Customizing Fonts</a>: Using alternate fonts.
5048
<li><a accesskey="4" href="#Toggling-Windows">Toggling Windows</a>: Turning off windows.
5049
<li><a accesskey="5" href="#Text-Fields">Text Fields</a>: Popdown histories.
5050
<li><a accesskey="6" href="#Icons">Icons</a>: Iconifying <acronym>DDD</acronym> windows.
5051
<li><a accesskey="7" href="#Adding-Buttons">Adding Buttons</a>: Create your own button set.
5052
<li><a accesskey="8" href="#More-Customizations">More Customizations</a>
5893
5053
</ul>
5894
5054
5895
5055
<div class="node">
5896
5056
<p><hr>
5897
<small class=header>
5898
Node:<a name="Splash%20Screen">Splash Screen</a>,
5899
Next:<a rel="next" accesskey="n" href="#Window%20Layout">Window Layout</a>,
5900
Up:<a rel="up" accesskey="u" href="#Customizing%20Windows">Customizing Windows</a>
5057
<a name="Splash-Screen"></a>
5058
Next: <a rel="next" accesskey="n" href="#Window-Layout">Window Layout</a>,
5059
Up: <a rel="up" accesskey="u" href="#Customizing-Windows">Customizing Windows</a>
5901
5060
</small>
5902
5061
5903
<br>
5062
5904
5063
</div>
5905
5064
5906
<h5 class="subsubsection">Splash Screen</h5>
5907
5908
<p>You can turn off the <small>DDD</small> splash screen shown upon startup. Just
5909
select <code>Edit => Preferences => Startup </code><small>DDD</small><code>
5910
Splash Screen</code>.
5911
5912
<br><p>
5065
<h5 class="subsubsection">3.6.4.1 Splash Screen</h5>
5066
5067
<p><a name="index-g_t_0040value_007bDDD_007d-Splash-Screen-574"></a>You can turn off the <acronym>DDD</acronym> splash screen shown upon startup. Just
5068
select ‘<samp><span class="samp">Edit Preferences Startup <acronym>DDD</acronym>
5069
Splash Screen</span></samp>’.
5070
5071
<pre class="sp">
5072
5073
</pre>
5913
5074
<div align="center"><img src="PICS/ddd-startup-prefs.jpg" alt="PICS/ddd-startup-prefs.jpg"></div>
5914
<br><p>
5915
<p>The value applies only to the next <small>DDD</small> invocation.
5075
<pre class="sp">
5076
5077
</pre>
5078
5079
The value applies only to the next <acronym>DDD</acronym> invocation.
5916
5080
5917
5081
<p>This setting is related to the following resource:
5918
5082
5919
<p>
5920
<table width="100%">
5921
<tr>
5922
<td align="left"><b>splashScreen</b><i> </i>(<i>class SplashScreen</i>)<i>
5923
</i></td>
5924
<td align="right">Resource</td>
5925
</tr>
5926
</table>
5927
<table width="95%" align="center">
5928
<tr><td>
5929
If <code>on</code> (default), show a <small>DDD</small> splash screen upon
5083
<div class="defun">
5084
— Resource: <b>splashScreen</b> (<var>class SplashScreen</var>)<var><a name="index-splashScreen-575"></a></var><br>
5085
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), show a <acronym>DDD</acronym> splash screen upon
5930
5086
start-up.
5931
</td></tr>
5932
</table>
5087
</p></blockquote></div>
5933
5088
5934
5089
<p>You can also customize the appearance of the splash screen
5935
5090
(see <a href="#Customizing">Customizing</a>):
5936
5091
5937
<p>
5938
<table width="100%">
5939
<tr>
5940
<td align="left"><b>splashScreenColorKey</b><i> </i>(<i>class ColorKey</i>)<i>
5941
</i></td>
5942
<td align="right">Resource</td>
5943
</tr>
5944
</table>
5945
<table width="95%" align="center">
5946
<tr><td>
5947
The color key to use for the <small>DDD</small> splash screen. Possible
5092
<div class="defun">
5093
— Resource: <b>splashScreenColorKey</b> (<var>class ColorKey</var>)<var><a name="index-splashScreenColorKey-576"></a></var><br>
5094
<blockquote><p>The color key to use for the <acronym>DDD</acronym> splash screen. Possible
5948
5095
values include:
5949
5096
5950
5097
<ul>
5951
<li><code>c</code> (default) for a color visual,
5952
<li><code>g</code> for a multi-level greyscale visual,
5953
<li><code>g4</code> for a 4-level greyscale visual, and
5954
<li><code>m</code> for a dithered monochrome visual.
5955
<li><code>best</code> chooses the best visual available for your display.
5098
<li>‘<samp><span class="samp">c</span></samp>’ (default) for a color visual,
5099
<li>‘<samp><span class="samp">g</span></samp>’ for a multi-level greyscale visual,
5100
<li>‘<samp><span class="samp">g4</span></samp>’ for a 4-level greyscale visual, and
5101
<li>‘<samp><span class="samp">m</span></samp>’ for a dithered monochrome visual.
5102
<li>‘<samp><span class="samp">best</span></samp>’ chooses the best visual available for your display.
5956
5103
</ul>
5957
5104
5958
<p>Please note: if <small>DDD</small> runs on a monochrome display, or if <small>DDD</small> was
5959
compiled without the <small>XPM</small> library, only the monochrome version
5960
(<code>m</code>) can be shown.
5961
</td></tr>
5962
</table>
5105
<p>Please note: if <acronym>DDD</acronym> runs on a monochrome display, or if <acronym>DDD</acronym> was
5106
compiled without the <acronym>XPM</acronym> library, only the monochrome version
5107
(‘<samp><span class="samp">m</span></samp>’) can be shown.
5108
</p></blockquote></div>
5963
5109
5964
5110
<div class="node">
5965
5111
<p><hr>
5966
<small class=header>
5967
Node:<a name="Window%20Layout">Window Layout</a>,
5968
Next:<a rel="next" accesskey="n" href="#Customizing%20Fonts">Customizing Fonts</a>,
5969
Previous:<a rel="previous" accesskey="p" href="#Splash%20Screen">Splash Screen</a>,
5970
Up:<a rel="up" accesskey="u" href="#Customizing%20Windows">Customizing Windows</a>
5112
<a name="Window-Layout"></a>
5113
Next: <a rel="next" accesskey="n" href="#Customizing-Fonts">Customizing Fonts</a>,
5114
Previous: <a rel="previous" accesskey="p" href="#Splash-Screen">Splash Screen</a>,
5115
Up: <a rel="up" accesskey="u" href="#Customizing-Windows">Customizing Windows</a>
5971
5116
</small>
5972
5117
5973
<br>
5118
5974
5119
</div>
5975
5120
5976
<h5 class="subsubsection">Window Layout</h5>
5121
<h5 class="subsubsection">3.6.4.2 Window Layout</h5>
5977
5122
5978
<p>By default, <small>DDD</small> stacks commands, source, and data in one single
5123
<p><a name="index-Window-Layout-577"></a>By default, <acronym>DDD</acronym> stacks commands, source, and data in one single
5979
5124
top-level window. To have separate top-level windows for source, data,
5980
and debugger console, set <code>Edit => Preferences =>
5981
Startup => Window Layout => Separate Windows</code>.
5982
5983
<br><p>
5125
and debugger console, set ‘<samp><span class="samp">Edit Preferences
5126
Startup Window Layout Separate Windows</span></samp>’.
5127
5128
<pre class="sp">
5129
5130
</pre>
5984
5131
<div align="center"><img src="PICS/ddd-separate.jpg" alt="PICS/ddd-separate.jpg"></div>
5985
<br><p>
5986
<p>Here are the related <small>DDD</small> resources:
5987
5988
<p>
5989
<table width="100%">
5990
<tr>
5991
<td align="left"><b>separateDataWindow</b><i> </i>(<i>class Separate</i>)<i>
5992
</i></td>
5993
<td align="right">Resource</td>
5994
</tr>
5995
</table>
5996
<table width="95%" align="center">
5997
<tr><td>
5998
If <code>on</code>, the data window and the debugger console are realized in
5999
different top-level windows. If <code>off</code> (default), the data window
6000
is attached to the debugger console.
6001
</td></tr>
6002
</table>
6003
6004
<p>
6005
<table width="100%">
6006
<tr>
6007
<td align="left"><b>separateSourceWindow</b><i> </i>(<i>class Separate</i>)<i>
6008
</i></td>
6009
<td align="right">Resource</td>
6010
</tr>
6011
</table>
6012
<table width="95%" align="center">
6013
<tr><td>
6014
If <code>on</code>, the source window and the debugger console are realized in
6015
different top-level windows. If <code>off</code> (default), the source window
6016
is attached to the debugger console.
6017
</td></tr>
6018
</table>
6019
6020
<p>By default, the <small>DDD</small> tool bars are located on top of the window.
5132
<pre class="sp">
5133
5134
</pre>
5135
5136
Here are the related <acronym>DDD</acronym> resources:
5137
5138
<div class="defun">
5139
— Resource: <b>separateDataWindow</b> (<var>class Separate</var>)<var><a name="index-separateDataWindow-578"></a></var><br>
5140
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, the data window and the debugger console are realized in
5141
different top-level windows. If ‘<samp><span class="samp">off</span></samp>’ (default), the data window
5142
is attached to the debugger console.
5143
</p></blockquote></div>
5144
5145
<div class="defun">
5146
— Resource: <b>separateSourceWindow</b> (<var>class Separate</var>)<var><a name="index-separateSourceWindow-579"></a></var><br>
5147
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, the source window and the debugger console are realized in
5148
different top-level windows. If ‘<samp><span class="samp">off</span></samp>’ (default), the source window
5149
is attached to the debugger console.
5150
</p></blockquote></div>
5151
5152
<p><a name="index-Tool-Bar-Appearance-580"></a><a name="index-Tool-Bar_002c-location-581"></a>By default, the <acronym>DDD</acronym> tool bars are located on top of the window.
6021
5153
If you prefer the tool bar being located at the bottom, as in
6022
<small>DDD</small> 2.x and earlier, set <code>Edit => Preferences
6023
=> Startup => Tool Bar Appearance => Bottom</code>.
6024
6025
<p>This is related to the <code>toolbarsAtBottom</code> resource:
6026
6027
<p>
6028
<table width="100%">
6029
<tr>
6030
<td align="left"><b>toolbarsAtBottom</b><i> </i>(<i>class ToolbarsAtBottom</i>)<i>
6031
</i></td>
6032
<td align="right">Resource</td>
6033
</tr>
6034
</table>
6035
<table width="95%" align="center">
6036
<tr><td>
6037
Whether source and data tool bars should be placed above source and
6038
data, respectively (<code>off</code>, default), or below, as in <small>DDD</small>
6039
2.x (<code>on</code>).
6040
</td></tr>
6041
</table>
6042
6043
<p>The bottom setting is only supported for separate tool bars--that is,
5154
<acronym>DDD</acronym> 2.x and earlier, set ‘<samp><span class="samp">Edit Preferences
5155
Startup Tool Bar Appearance Bottom</span></samp>’.
5156
5157
<p>This is related to the ‘<samp><span class="samp">toolbarsAtBottom</span></samp>’ resource:
5158
5159
<div class="defun">
5160
— Resource: <b>toolbarsAtBottom</b> (<var>class ToolbarsAtBottom</var>)<var><a name="index-toolbarsAtBottom-582"></a></var><br>
5161
<blockquote><p>Whether source and data tool bars should be placed above source and
5162
data, respectively (‘<samp><span class="samp">off</span></samp>’, default), or below, as in <acronym>DDD</acronym>
5163
2.x (‘<samp><span class="samp">on</span></samp>’).
5164
</p></blockquote></div>
5165
5166
<p>The bottom setting is only supported for separate tool bars—that is,
6044
5167
you must either choose separate windows or configure the tool bar to
6045
have neither images nor captions (see <a href="#Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>).
5168
have neither images nor captions (see <a href="#Customizing-the-Tool-Bar">Customizing the Tool Bar</a>).
6046
5169
6047
5170
<p>If you use stacked windows, you can choose whether there should be one
6048
tool bar or two tool bars. By default, <small>DDD</small> uses two tool bars
5171
tool bar or two tool bars. By default, <acronym>DDD</acronym> uses two tool bars
6049
5172
if you use separate windows and disable captions and images, but you can
6050
5173
also explicitly change the setting via this resource:
6051
5174
6052
<p>
6053
<table width="100%">
6054
<tr>
6055
<td align="left"><b>commonToolBar</b><i> </i>(<i>class ToolBar</i>)<i>
6056
</i></td>
6057
<td align="right">Resource</td>
6058
</tr>
6059
</table>
6060
<table width="95%" align="center">
6061
<tr><td>
6062
Whether the tool bar buttons should be shown in one common tool bar at
6063
the top of the common <small>DDD</small> window (<code>on</code>, default), or
5175
<div class="defun">
5176
— Resource: <b>commonToolBar</b> (<var>class ToolBar</var>)<var><a name="index-commonToolBar-583"></a></var><br>
5177
<blockquote><p>Whether the tool bar buttons should be shown in one common tool bar at
5178
the top of the common <acronym>DDD</acronym> window (‘<samp><span class="samp">on</span></samp>’, default), or
6064
5179
whether they should be placed in two separate tool bars, one for data,
6065
and one for source operations, as in <small>DDD</small> 2.x (<code>off</code>).
6066
</td></tr>
6067
</table>
5180
and one for source operations, as in <acronym>DDD</acronym> 2.x (‘<samp><span class="samp">off</span></samp>’).
5181
</p></blockquote></div>
6068
5182
6069
<p>You can also change the location of the <em>status line</em>
5183
<p><a name="index-Status-line_002c-location-584"></a>You can also change the location of the <em>status line</em>
6070
5184
(see <a href="#Customizing">Customizing</a>):
6071
5185
6072
<p>
6073
<table width="100%">
6074
<tr>
6075
<td align="left"><b>statusAtBottom</b><i> </i>(<i>class StatusAtBottom</i>)<i>
6076
</i></td>
6077
<td align="right">Resource</td>
6078
</tr>
6079
</table>
6080
<table width="95%" align="center">
6081
<tr><td>
6082
If <code>on</code> (default), the status line is placed at the bottom of the
6083
<small>DDD</small> source window. If <code>off</code>, the status line is placed at
6084
the top of the <small>DDD</small> source window (as in <small>DDD</small> 1.x).
6085
</td></tr>
6086
</table>
5186
<div class="defun">
5187
— Resource: <b>statusAtBottom</b> (<var>class StatusAtBottom</var>)<var><a name="index-statusAtBottom-585"></a></var><br>
5188
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), the status line is placed at the bottom of the
5189
<acronym>DDD</acronym> source window. If ‘<samp><span class="samp">off</span></samp>’, the status line is placed at
5190
the top of the <acronym>DDD</acronym> source window (as in <acronym>DDD</acronym> 1.x).
5191
</p></blockquote></div>
6087
5192
6088
<p>See <a href="#Options">Options</a>, for options to set these resources upon <small>DDD</small>
5193
<p>See <a href="#Options">Options</a>, for options to set these resources upon <acronym>DDD</acronym>
6089
5194
invocation.
6090
5195
6091
5196
<div class="node">
6092
5197
<p><hr>
6093
<small class=header>
6094
Node:<a name="Customizing%20Fonts">Customizing Fonts</a>,
6095
Next:<a rel="next" accesskey="n" href="#Toggling%20Windows">Toggling Windows</a>,
6096
Previous:<a rel="previous" accesskey="p" href="#Window%20Layout">Window Layout</a>,
6097
Up:<a rel="up" accesskey="u" href="#Customizing%20Windows">Customizing Windows</a>
5198
<a name="Customizing-Fonts"></a>
5199
Next: <a rel="next" accesskey="n" href="#Toggling-Windows">Toggling Windows</a>,
5200
Previous: <a rel="previous" accesskey="p" href="#Window-Layout">Window Layout</a>,
5201
Up: <a rel="up" accesskey="u" href="#Customizing-Windows">Customizing Windows</a>
6098
5202
</small>
6099
5203
6100
<br>
5204
6101
5205
</div>
6102
5206
6103
<h5 class="subsubsection">Customizing Fonts</h5>
5207
<h5 class="subsubsection">3.6.4.3 Customizing Fonts</h5>
6104
5208
6105
<p>You can configure the basic <small>DDD</small> fonts at run-time. Each
5209
<p><a name="index-Fonts-586"></a>
5210
You can configure the basic <acronym>DDD</acronym> fonts at run-time. Each
6106
5211
font is specified using two members:
6107
5212
6108
5213
<ul>
6109
5214
<li>The <dfn>font family</dfn> is an X font specifications, where the initial
6110
<code></code><var>foundry</var><code>-</code> specification may be omitted, as well as any
5215
‘<samp><var>foundry</var><span class="samp">-</span></samp>’ specification may be omitted, as well as any
6111
5216
specification after <var>family</var>. Thus, a pair
6112
<code></code><var>family</var><code>-</code><var>weight</var><code></code> usually suffices.
5217
‘<samp><var>family</var><span class="samp">-</span><var>weight</var></samp>’ usually suffices.
6113
5218
6114
5219
<li>The <dfn>font size</dfn> is given as (resolution-independent) 1/10 points.
6115
5220
</ul>
6116
5221
6117
<p>To specify fonts, select <code>Edit => Preferences =>
6118
Fonts</code>.
6119
6120
<br><p>
5222
<p>To specify fonts, select ‘<samp><span class="samp">Edit Preferences
5223
Fonts</span></samp>’.
5224
5225
<pre class="sp">
5226
5227
</pre>
6121
5228
<div align="center"><img src="PICS/ddd-font-prefs.jpg" alt="PICS/ddd-font-prefs.jpg"></div>
6122
<br><p>
6123
<p>The <code>Browse</code> button opens a font selection program, where you can
6124
select fonts and attributes interactively. Clicking <code>quit</code> or
6125
<code>select</code> in the font selector causes all non-default values to be
6126
transferred to the <small>DDD</small> font preferences panel.
5229
<pre class="sp">
5230
5231
</pre>
5232
5233
The ‘<samp><span class="samp">Browse</span></samp>’ button opens a font selection program, where you can
5234
select fonts and attributes interactively. Clicking ‘<samp><span class="samp">quit</span></samp>’ or
5235
‘<samp><span class="samp">select</span></samp>’ in the font selector causes all non-default values to be
5236
transferred to the <acronym>DDD</acronym> font preferences panel.
6127
5237
6128
5238
<p>The following fonts can be set using the preferences panel:
6129
5239
6130
5240
<dl>
6131
<dt><code>Default Font</code>
6132
<dd>The default <small>DDD</small> font to use for labels, menus, and buttons.
6133
Default is <code>helvetica-bold</code>.
6134
6135
<br><dt><code>Variable Width</code>
6136
<dd>The variable width <small>DDD</small> font to use for help texts and messages.
6137
Default is <code>helvetica-medium</code>.
6138
6139
<br><dt><code>Fixed Width</code>
6140
<dd>The fixed width <small>DDD</small> font to use for source code, the debugger
5241
<dt><code>Default Font</code><dd>The default <acronym>DDD</acronym> font to use for labels, menus, and buttons.
5242
Default is ‘<samp><span class="samp">helvetica-bold</span></samp>’.
5243
5244
<br><dt><code>Variable Width</code><dd>The variable width <acronym>DDD</acronym> font to use for help texts and messages.
5245
Default is ‘<samp><span class="samp">helvetica-medium</span></samp>’.
5246
5247
<br><dt><code>Fixed Width</code><dd>The fixed width <acronym>DDD</acronym> font to use for source code, the debugger
6141
5248
console, text fields, and the execution window. Default
6142
is <code>lucidatypewriter-medium</code>.
5249
is ‘<samp><span class="samp">lucidatypewriter-medium</span></samp>’.
6143
5250
6144
<br><dt><code>Data</code>
6145
<dd>The <small>DDD</small> font to use for data displays. Default
6146
is <code>lucidatypewriter-medium</code>.
5251
<br><dt><code>Data</code><dd>The <acronym>DDD</acronym> font to use for data displays. Default
5252
is ‘<samp><span class="samp">lucidatypewriter-medium</span></samp>’.
6147
5253
</dl>
6148
5254
6149
<p>Changes in this panel will take effect only in the next <small>DDD</small> session.
6150
To make it effective right now, restart <small>DDD</small> (using <code>File
6151
=> Restart </code><small>DDD</small><code></code>).
5255
<p>Changes in this panel will take effect only in the next <acronym>DDD</acronym> session.
5256
To make it effective right now, restart <acronym>DDD</acronym> (using ‘<samp><span class="samp">File
5257
Restart <acronym>DDD</acronym></span></samp>’).
6152
5258
6153
<p>After having made changes in the panel, <small>DDD</small> will automatically
5259
<p>After having made changes in the panel, <acronym>DDD</acronym> will automatically
6154
5260
offer you to restart itself, such that you can see the changes taking
6155
5261
effect.
6156
5262
6157
<p>The <code>Reset</code> button restores the most recently saved preferences.
5263
<p>The ‘<samp><span class="samp">Reset</span></samp>’ button restores the most recently saved preferences.
6158
5264
6159
5265
<p>Here are the resources related to font specifications:
6160
5266
6161
<p>
6162
<table width="100%">
6163
<tr>
6164
<td align="left"><b>defaultFont</b><i> </i>(<i>class Font</i>)<i>
6165
</i></td>
6166
<td align="right">Resource</td>
6167
</tr>
6168
</table>
6169
<table width="95%" align="center">
6170
<tr><td>
6171
The default <small>DDD</small> font to use for labels, menus, buttons, etc.
5267
<div class="defun">
5268
— Resource: <b>defaultFont</b> (<var>class Font</var>)<var><a name="index-defaultFont-587"></a></var><br>
5269
<blockquote><p>The default <acronym>DDD</acronym> font to use for labels, menus, buttons, etc.
6172
5270
The font is specified as an X font spec, where the initial <var>Foundry</var>
6173
5271
specification may be omitted, as well as any specification after
6174
5272
<var>Family</var>.
6175
5273
6176
<p>Default value is <code>helvetica-bold</code>.
5274
<p>Default value is ‘<samp><span class="samp">helvetica-bold</span></samp>’.
6177
5275
6178
<p>To set the default <small>DDD</small> font to, say, <code>helvetica medium</code>,
5276
<p>To set the default <acronym>DDD</acronym> font to, say, ‘<samp><span class="samp">helvetica medium</span></samp>’,
6179
5277
insert a line
6180
5278
6181
5279
<pre class="example"> Ddd*defaultFont: helvetica-medium
6182
</pre>
6183
6184
<p>in your <code>~/.ddd/init</code> file.
6185
</td></tr>
6186
</table>
6187
6188
<p>
6189
<table width="100%">
6190
<tr>
6191
<td align="left"><b>defaultFontSize</b><i> </i>(<i>class FontSize</i>)<i>
6192
</i></td>
6193
<td align="right">Resource</td>
6194
</tr>
6195
</table>
6196
<table width="95%" align="center">
6197
<tr><td>
6198
The size of the default <small>DDD</small> font, in 1/10 points. This resource
6199
overrides any font size specification in the <code>defaultFont</code> resource
5280
</pre>
5281
<p class="noindent">in your <samp><span class="file">~/.ddd/init</span></samp> file.
5282
</p></blockquote></div>
5283
5284
<div class="defun">
5285
— Resource: <b>defaultFontSize</b> (<var>class FontSize</var>)<var><a name="index-defaultFontSize-588"></a></var><br>
5286
<blockquote><p>The size of the default <acronym>DDD</acronym> font, in 1/10 points. This resource
5287
overrides any font size specification in the ‘<samp><span class="samp">defaultFont</span></samp>’ resource
6200
5288
(see above). The default value is <code>120</code> for a 12.0 point font.
6201
</td></tr>
6202
</table>
5289
</p></blockquote></div>
6203
5290
6204
<p>
6205
<table width="100%">
6206
<tr>
6207
<td align="left"><b>variableWidthFont</b><i> </i>(<i>class Font</i>)<i>
6208
</i></td>
6209
<td align="right">Resource</td>
6210
</tr>
6211
</table>
6212
<table width="95%" align="center">
6213
<tr><td>
6214
The variable width <small>DDD</small> font to use for help texts and messages.
5291
<div class="defun">
5292
— Resource: <b>variableWidthFont</b> (<var>class Font</var>)<var><a name="index-variableWidthFont-589"></a></var><br>
5293
<blockquote><p>The variable width <acronym>DDD</acronym> font to use for help texts and messages.
6215
5294
The font is specified as an X font spec, where the initial <var>Foundry</var>
6216
5295
specification may be omitted, as well as any specification after
6217
5296
<var>Family</var>.
6218
5297
6219
<p>Default value is <code>helvetica-medium-r</code>.
5298
<p>Default value is ‘<samp><span class="samp">helvetica-medium-r</span></samp>’.
6220
5299
6221
<p>To set the variable width <small>DDD</small> font family to, say,
6222
<code>times</code>, insert a line
5300
<p>To set the variable width <acronym>DDD</acronym> font family to, say,
5301
‘<samp><span class="samp">times</span></samp>’, insert a line
6223
5302
6224
5303
<pre class="example"> Ddd*fixedWidthFont: times-medium
6225
</pre>
6226
6227
<p>in your <code>~/.ddd/init</code> file.
6228
</td></tr>
6229
</table>
6230
6231
<p>
6232
<table width="100%">
6233
<tr>
6234
<td align="left"><b>variableWidthFontSize</b><i> </i>(<i>class FontSize</i>)<i>
6235
</i></td>
6236
<td align="right">Resource</td>
6237
</tr>
6238
</table>
6239
<table width="95%" align="center">
6240
<tr><td>
6241
The size of the variable width <small>DDD</small> font, in 1/10 points. This
5304
</pre>
5305
<p class="noindent">in your <samp><span class="file">~/.ddd/init</span></samp> file.
5306
</p></blockquote></div>
5307
5308
<div class="defun">
5309
— Resource: <b>variableWidthFontSize</b> (<var>class FontSize</var>)<var><a name="index-variableWidthFontSize-590"></a></var><br>
5310
<blockquote><p>The size of the variable width <acronym>DDD</acronym> font, in 1/10 points. This
6242
5311
resource overrides any font size specification in the
6243
<code>variableWidthFont</code> resource (see above). The default value is
5312
‘<samp><span class="samp">variableWidthFont</span></samp>’ resource (see above). The default value is
6244
5313
<code>120</code> for a 12.0 point font.
6245
</td></tr>
6246
</table>
5314
</p></blockquote></div>
6247
5315
6248
<p>
6249
<table width="100%">
6250
<tr>
6251
<td align="left"><b>fixedWidthFont</b><i> </i>(<i>class Font</i>)<i>
6252
</i></td>
6253
<td align="right">Resource</td>
6254
</tr>
6255
</table>
6256
<table width="95%" align="center">
6257
<tr><td>
6258
The fixed width <small>DDD</small> font to use for source code, the debugger
5316
<div class="defun">
5317
— Resource: <b>fixedWidthFont</b> (<var>class Font</var>)<var><a name="index-fixedWidthFont-591"></a></var><br>
5318
<blockquote><p>The fixed width <acronym>DDD</acronym> font to use for source code, the debugger
6259
5319
console, text fields, and the execution window. The font
6260
5320
is specified as an X font spec, where the initial <var>Foundry</var>
6261
5321
specification may be omitted, as well as any specification after
6262
5322
<var>Family</var>.
6263
5323
6264
<p>Default value is <code>lucidatypewriter-medium</code>.
5324
<p>Default value is ‘<samp><span class="samp">lucidatypewriter-medium</span></samp>’.
6265
5325
6266
<p>To set the fixed width <small>DDD</small> font family to, say, <code>courier</code>,
5326
<p>To set the fixed width <acronym>DDD</acronym> font family to, say, ‘<samp><span class="samp">courier</span></samp>’,
6267
5327
insert a line
6268
5328
6269
5329
<pre class="example"> Ddd*fixedWidthFont: courier-medium
6270
</pre>
6271
6272
<p>in your <code>~/.ddd/init</code> file.
6273
</td></tr>
6274
</table>
6275
6276
<p>
6277
<table width="100%">
6278
<tr>
6279
<td align="left"><b>fixedWidthFontSize</b><i> </i>(<i>class FontSize</i>)<i>
6280
</i></td>
6281
<td align="right">Resource</td>
6282
</tr>
6283
</table>
6284
<table width="95%" align="center">
6285
<tr><td>
6286
The size of the fixed width <small>DDD</small> font, in 1/10 points. This
5330
</pre>
5331
<p class="noindent">in your <samp><span class="file">~/.ddd/init</span></samp> file.
5332
</p></blockquote></div>
5333
5334
<div class="defun">
5335
— Resource: <b>fixedWidthFontSize</b> (<var>class FontSize</var>)<var><a name="index-fixedWidthFontSize-592"></a></var><br>
5336
<blockquote><p>The size of the fixed width <acronym>DDD</acronym> font, in 1/10 points. This
6287
5337
resource overrides any font size specification in the
6288
<code>fixedWidthFont</code> resource (see above). The default value is
5338
‘<samp><span class="samp">fixedWidthFont</span></samp>’ resource (see above). The default value is
6289
5339
<code>120</code> for a 12.0 point font.
6290
</td></tr>
6291
</table>
5340
</p></blockquote></div>
6292
5341
6293
<p>
6294
<table width="100%">
6295
<tr>
6296
<td align="left"><b>dataFont</b><i> </i>(<i>class Font</i>)<i>
6297
</i></td>
6298
<td align="right">Resource</td>
6299
</tr>
6300
</table>
6301
<table width="95%" align="center">
6302
<tr><td>
6303
The fixed width <small>DDD</small> font to use data displays. The font
5342
<div class="defun">
5343
— Resource: <b>dataFont</b> (<var>class Font</var>)<var><a name="index-dataFont-593"></a></var><br>
5344
<blockquote><p>The fixed width <acronym>DDD</acronym> font to use data displays. The font
6304
5345
is specified as an X font spec, where the initial <var>Foundry</var>
6305
5346
specification may be omitted, as well as any specification after
6306
5347
<var>Family</var>.
6307
5348
6308
<p>Default value is <code>lucidatypewriter-medium</code>.
5349
<p>Default value is ‘<samp><span class="samp">lucidatypewriter-medium</span></samp>’.
6309
5350
6310
<p>To set the <small>DDD</small> data font family to, say, <code>courier</code>,
5351
<p>To set the <acronym>DDD</acronym> data font family to, say, ‘<samp><span class="samp">courier</span></samp>’,
6311
5352
insert a line
6312
5353
6313
5354
<pre class="example"> Ddd*dataFont: courier-medium
6314
</pre>
6315
6316
<p>in your <code>~/.ddd/init</code> file.
6317
</td></tr>
6318
</table>
6319
6320
<p>
6321
<table width="100%">
6322
<tr>
6323
<td align="left"><b>dataFontSize</b><i> </i>(<i>class FontSize</i>)<i>
6324
</i></td>
6325
<td align="right">Resource</td>
6326
</tr>
6327
</table>
6328
<table width="95%" align="center">
6329
<tr><td>
6330
The size of the <small>DDD</small> data font, in 1/10 points. This
5355
</pre>
5356
<p class="noindent">in your <samp><span class="file">~/.ddd/init</span></samp> file.
5357
</p></blockquote></div>
5358
5359
<div class="defun">
5360
— Resource: <b>dataFontSize</b> (<var>class FontSize</var>)<var><a name="index-dataFontSize-594"></a></var><br>
5361
<blockquote><p>The size of the <acronym>DDD</acronym> data font, in 1/10 points. This
6331
5362
resource overrides any font size specification in the
6332
<code>dataFont</code> resource (see above). The default value is
5363
‘<samp><span class="samp">dataFont</span></samp>’ resource (see above). The default value is
6333
5364
<code>120</code> for a 12.0 point font.
6334
</td></tr>
6335
</table>
5365
</p></blockquote></div>
6336
5366
6337
5367
<p>As all font size resources have the same class (and by default the
6338
same value), you can easily change the default <small>DDD</small> font size
5368
same value), you can easily change the default <acronym>DDD</acronym> font size
6339
5369
to, say, 9.0 points by inserting a line
6340
5370
6341
5371
<pre class="example"> Ddd*FontSize: 90
6342
</pre>
6343
6344
<p>in your <code>~/.ddd/init</code> file.
5372
</pre>
5373
<p class="noindent">in your <samp><span class="file">~/.ddd/init</span></samp> file.
6345
5374
6346
5375
<p>Here's how to specify the command to select fonts:
6347
5376
6348
<p>
6349
<table width="100%">
6350
<tr>
6351
<td align="left"><b>fontSelectCommand</b><i> </i>(<i>class FontSelectCommand</i>)<i>
6352
</i></td>
6353
<td align="right">Resource</td>
6354
</tr>
6355
</table>
6356
<table width="95%" align="center">
6357
<tr><td>
6358
A command to select from a list of fonts. The string <code>@FONT@</code> is
6359
replaced by the current <small>DDD</small> default font; the string
6360
<code>@TYPE@</code> is replaced by a symbolic name of the <small>DDD</small> font
5377
<div class="defun">
5378
— Resource: <b>fontSelectCommand</b> (<var>class FontSelectCommand</var>)<var><a name="index-fontSelectCommand-595"></a></var><br>
5379
<blockquote><p>A command to select from a list of fonts. The string ‘<samp><span class="samp">@FONT@</span></samp>’ is
5380
replaced by the current <acronym>DDD</acronym> default font; the string
5381
‘<samp><span class="samp">@TYPE@</span></samp>’ is replaced by a symbolic name of the <acronym>DDD</acronym> font
6361
5382
to edit. The program must either place the name of the selected font in
6362
5383
the <code>PRIMARY</code> selection or print the selected font on standard
6363
5384
output. A typical value is:
6364
5385
<pre class="example"> Ddd*fontSelectCommand: xfontsel -print
6365
</pre>
6366
</td></tr>
6367
</table>
5386
</pre>
5387
<p><a name="index-xfontsel-596"></a></p></blockquote></div>
6368
5388
6369
<p>See <a href="#Options">Options</a>, for options to set these resources upon <small>DDD</small>
5389
<p>See <a href="#Options">Options</a>, for options to set these resources upon <acronym>DDD</acronym>
6370
5390
invocation.
6371
5391
6372
5392
<div class="node">
6373
5393
<p><hr>
6374
<small class=header>
6375
Node:<a name="Toggling%20Windows">Toggling Windows</a>,
6376
Next:<a rel="next" accesskey="n" href="#Text%20Fields">Text Fields</a>,
6377
Previous:<a rel="previous" accesskey="p" href="#Customizing%20Fonts">Customizing Fonts</a>,
6378
Up:<a rel="up" accesskey="u" href="#Customizing%20Windows">Customizing Windows</a>
5394
<a name="Toggling-Windows"></a>
5395
Next: <a rel="next" accesskey="n" href="#Text-Fields">Text Fields</a>,
5396
Previous: <a rel="previous" accesskey="p" href="#Customizing-Fonts">Customizing Fonts</a>,
5397
Up: <a rel="up" accesskey="u" href="#Customizing-Windows">Customizing Windows</a>
6379
5398
</small>
6380
5399
6381
<br>
5400
6382
5401
</div>
6383
5402
6384
<h5 class="subsubsection">Toggling Windows</h5>
6385
6386
<p>In the default stacked window setting, you can turn the individual
6387
<small>DDD</small> windows on and off by toggling the respective items in the
6388
<code>View</code> menu (see <a href="#View%20Menu">View Menu</a>). When using separate windows
6389
(see <a href="#Window%20Layout">Window Layout</a>), you can close the individual windows via
6390
<code>File => Close</code> or by closing them via your window manager.
6391
6392
<p>Whether windows are opened or closed when starting <small>DDD</small> is
5403
<h5 class="subsubsection">3.6.4.4 Toggling Windows</h5>
5404
5405
<p>In the default stacked window setting, you can turn the individual
5406
<acronym>DDD</acronym> windows on and off by toggling the respective items in the
5407
‘<samp><span class="samp">View</span></samp>’ menu (see <a href="#View-Menu">View Menu</a>). When using separate windows
5408
(see <a href="#Window-Layout">Window Layout</a>), you can close the individual windows via
5409
‘<samp><span class="samp">File Close</span></samp>’ or by closing them via your window manager.
5410
5411
<p>Whether windows are opened or closed when starting <acronym>DDD</acronym> is
6393
5412
controlled by the following resources, immediately tied to the
6394
<code>View</code> menu items:
6395
6396
<p>
6397
<table width="100%">
6398
<tr>
6399
<td align="left"><b>openDataWindow</b><i> </i>(<i>class Window</i>)<i>
6400
</i></td>
6401
<td align="right">Resource</td>
6402
</tr>
6403
</table>
6404
<table width="95%" align="center">
6405
<tr><td>
6406
If <code>off</code> (default), the data window is closed upon start-up.
6407
</td></tr>
6408
</table>
6409
6410
<p>
6411
<table width="100%">
6412
<tr>
6413
<td align="left"><b>openDebuggerConsole</b><i> </i>(<i>class Window</i>)<i>
6414
</i></td>
6415
<td align="right">Resource</td>
6416
</tr>
6417
</table>
6418
<table width="95%" align="center">
6419
<tr><td>
6420
If <code>off</code>, the debugger console is closed upon start-up.
6421
</td></tr>
6422
</table>
6423
6424
<p>
6425
<table width="100%">
6426
<tr>
6427
<td align="left"><b>openSourceWindow</b><i> </i>(<i>class Window</i>)<i>
6428
</i></td>
6429
<td align="right">Resource</td>
6430
</tr>
6431
</table>
6432
<table width="95%" align="center">
6433
<tr><td>
6434
If <code>off</code>, the source window is closed upon start-up.
6435
</td></tr>
6436
</table>
6437
6438
<p>See <a href="#Options">Options</a>, for options to set these resources upon <small>DDD</small>
5413
‘<samp><span class="samp">View</span></samp>’ menu items:
5414
5415
<div class="defun">
5416
— Resource: <b>openDataWindow</b> (<var>class Window</var>)<var><a name="index-openDataWindow-597"></a></var><br>
5417
<blockquote><p>If ‘<samp><span class="samp">off</span></samp>’ (default), the data window is closed upon start-up.
5418
</p></blockquote></div>
5419
5420
<div class="defun">
5421
— Resource: <b>openDebuggerConsole</b> (<var>class Window</var>)<var><a name="index-openDebuggerConsole-598"></a></var><br>
5422
<blockquote><p>If ‘<samp><span class="samp">off</span></samp>’, the debugger console is closed upon start-up.
5423
</p></blockquote></div>
5424
5425
<div class="defun">
5426
— Resource: <b>openSourceWindow</b> (<var>class Window</var>)<var><a name="index-openSourceWindow-599"></a></var><br>
5427
<blockquote><p>If ‘<samp><span class="samp">off</span></samp>’, the source window is closed upon start-up.
5428
</p></blockquote></div>
5429
5430
<p>See <a href="#Options">Options</a>, for options to set these resources upon <acronym>DDD</acronym>
6439
5431
invocation.
6440
5432
6441
5433
<div class="node">
6442
5434
<p><hr>
6443
<small class=header>
6444
Node:<a name="Text%20Fields">Text Fields</a>,
6445
Next:<a rel="next" accesskey="n" href="#Icons">Icons</a>,
6446
Previous:<a rel="previous" accesskey="p" href="#Toggling%20Windows">Toggling Windows</a>,
6447
Up:<a rel="up" accesskey="u" href="#Customizing%20Windows">Customizing Windows</a>
5435
<a name="Text-Fields"></a>
5436
Next: <a rel="next" accesskey="n" href="#Icons">Icons</a>,
5437
Previous: <a rel="previous" accesskey="p" href="#Toggling-Windows">Toggling Windows</a>,
5438
Up: <a rel="up" accesskey="u" href="#Customizing-Windows">Customizing Windows</a>
6448
5439
</small>
6449
5440
6450
<br>
5441
6451
5442
</div>
6452
5443
6453
<h5 class="subsubsection">Text Fields</h5>
5444
<h5 class="subsubsection">3.6.4.5 Text Fields</h5>
6454
5445
6455
<p>The <small>DDD</small> text fields can be customized using the following
5446
<p>The <acronym>DDD</acronym> text fields can be customized using the following
6456
5447
resources:
6457
5448
6458
<p>
6459
<table width="100%">
6460
<tr>
6461
<td align="left"><b>popdownHistorySize</b><i> </i>(<i>class HistorySize</i>)<i>
6462
</i></td>
6463
<td align="right">Resource</td>
6464
</tr>
6465
</table>
6466
<table width="95%" align="center">
6467
<tr><td>
6468
The maximum number of items to display in pop-down value histories. A
5449
<div class="defun">
5450
— Resource: <b>popdownHistorySize</b> (<var>class HistorySize</var>)<var><a name="index-popdownHistorySize-600"></a></var><br>
5451
<blockquote><p>The maximum number of items to display in pop-down value histories. A
6469
5452
value of <code>0</code> (default) means an unlimited number of values.
6470
</td></tr>
6471
</table>
5453
</p></blockquote></div>
6472
5454
6473
<p>
6474
<table width="100%">
6475
<tr>
6476
<td align="left"><b>sortPopdownHistory</b><i> </i>(<i>class SortPopdownHistory</i>)<i>
6477
</i></td>
6478
<td align="right">Resource</td>
6479
</tr>
6480
</table>
6481
<table width="95%" align="center">
6482
<tr><td>
6483
If <code>on</code> (default), items in the pop-down value histories are sorted
6484
alphabetically. If <code>off</code>, most recently used values will appear at
5455
<div class="defun">
5456
— Resource: <b>sortPopdownHistory</b> (<var>class SortPopdownHistory</var>)<var><a name="index-sortPopdownHistory-601"></a></var><br>
5457
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), items in the pop-down value histories are sorted
5458
alphabetically. If ‘<samp><span class="samp">off</span></samp>’, most recently used values will appear at
6485
5459
the top.
6486
</td></tr>
6487
</table>
5460
</p></blockquote></div>
6488
5461
6489
5462
<div class="node">
6490
5463
<p><hr>
6491
<small class=header>
6492
Node:<a name="Icons">Icons</a>,
6493
Next:<a rel="next" accesskey="n" href="#Adding%20Buttons">Adding Buttons</a>,
6494
Previous:<a rel="previous" accesskey="p" href="#Text%20Fields">Text Fields</a>,
6495
Up:<a rel="up" accesskey="u" href="#Customizing%20Windows">Customizing Windows</a>
5464
<a name="Icons"></a>
5465
Next: <a rel="next" accesskey="n" href="#Adding-Buttons">Adding Buttons</a>,
5466
Previous: <a rel="previous" accesskey="p" href="#Text-Fields">Text Fields</a>,
5467
Up: <a rel="up" accesskey="u" href="#Customizing-Windows">Customizing Windows</a>
6496
5468
</small>
6497
5469
6498
<br>
5470
6499
5471
</div>
6500
5472
6501
<h5 class="subsubsection">Icons</h5>
5473
<h5 class="subsubsection">3.6.4.6 Icons</h5>
6502
5474
6503
<p>If you frequently switch between <small>DDD</small> and other multi-window
6504
applications, you may like to set <code>Edit => Preferences
6505
=> General => Iconify all windows at once</code>. This
6506
way, all <small>DDD</small> windows are iconified and deiconified as a group.
5475
<p><a name="index-Iconify-all-windows-at-once-602"></a>If you frequently switch between <acronym>DDD</acronym> and other multi-window
5476
applications, you may like to set ‘<samp><span class="samp">Edit Preferences
5477
General Iconify all windows at once</span></samp>’. This
5478
way, all <acronym>DDD</acronym> windows are iconified and deiconified as a group.
6507
5479
6508
5480
<p>This is tied to the following resource:
6509
5481
6510
<p>
6511
<table width="100%">
6512
<tr>
6513
<td align="left"><b>groupIconify</b><i> </i>(<i>class GroupIconify</i>)<i>
6514
</i></td>
6515
<td align="right">Resource</td>
6516
</tr>
6517
</table>
6518
<table width="95%" align="center">
6519
<tr><td>
6520
If this is <code>on</code>, (un)iconifying any <small>DDD</small> window
6521
causes all other <small>DDD</small> windows to (un)iconify as well.
6522
Default is <code>off</code>, meaning that each <small>DDD</small> window can
5482
<div class="defun">
5483
— Resource: <b>groupIconify</b> (<var>class GroupIconify</var>)<var><a name="index-groupIconify-603"></a></var><br>
5484
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’, (un)iconifying any <acronym>DDD</acronym> window
5485
causes all other <acronym>DDD</acronym> windows to (un)iconify as well.
5486
Default is ‘<samp><span class="samp">off</span></samp>’, meaning that each <acronym>DDD</acronym> window can
6523
5487
be iconified on its own.
6524
</td></tr>
6525
</table>
5488
</p></blockquote></div>
6526
5489
6527
<p>If you want to keep <small>DDD</small> off your desktop during a longer
6528
computation, you may like to set <code>Edit => Preferences
6529
=> General => Uniconify when ready</code>. This way, you can
6530
iconify <small>DDD</small> while it is busy on a command (e.g. running a
6531
program); <small>DDD</small> will automatically pop up again after becoming
5490
<p>If you want to keep <acronym>DDD</acronym> off your desktop during a longer
5491
computation, you may like to set ‘<samp><span class="samp">Edit Preferences
5492
General Uniconify when ready</span></samp>’. This way, you can
5493
iconify <acronym>DDD</acronym> while it is busy on a command (e.g. running a
5494
program); <acronym>DDD</acronym> will automatically pop up again after becoming
6532
5495
ready (e.g. after the debugged program has stopped at a breakpoint).
6533
See <a href="#Program%20Stop">Program Stop</a>, for a discussion.
5496
See <a href="#Program-Stop">Program Stop</a>, for a discussion.
6534
5497
6535
5498
<p>Here is the related resource:
6536
5499
6537
<p>
6538
<table width="100%">
6539
<tr>
6540
<td align="left"><b>uniconifyWhenReady</b><i> </i>(<i>class UniconifyWhenReady</i>)<i>
6541
</i></td>
6542
<td align="right">Resource</td>
6543
</tr>
6544
</table>
6545
<table width="95%" align="center">
6546
<tr><td>
6547
If this is <code>on</code> (default), the <small>DDD</small> windows are uniconified
6548
automatically whenever <small>GDB</small> becomes ready. This way, you can iconify
6549
<small>DDD</small> during some longer operation and have it uniconify itself as
6550
soon as the program stops. Setting this to <code>off</code> leaves the
6551
<small>DDD</small> windows iconified.
6552
</td></tr>
6553
</table>
5500
<div class="defun">
5501
— Resource: <b>uniconifyWhenReady</b> (<var>class UniconifyWhenReady</var>)<var><a name="index-uniconifyWhenReady-604"></a></var><br>
5502
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’ (default), the <acronym>DDD</acronym> windows are uniconified
5503
automatically whenever <acronym>GDB</acronym> becomes ready. This way, you can iconify
5504
<acronym>DDD</acronym> during some longer operation and have it uniconify itself as
5505
soon as the program stops. Setting this to ‘<samp><span class="samp">off</span></samp>’ leaves the
5506
<acronym>DDD</acronym> windows iconified.
5507
</p></blockquote></div>
6554
5508
6555
5509
<div class="node">
6556
5510
<p><hr>
6557
<small class=header>
6558
Node:<a name="Adding%20Buttons">Adding Buttons</a>,
6559
Next:<a rel="next" accesskey="n" href="#More%20Customizations">More Customizations</a>,
6560
Previous:<a rel="previous" accesskey="p" href="#Icons">Icons</a>,
6561
Up:<a rel="up" accesskey="u" href="#Customizing%20Windows">Customizing Windows</a>
5511
<a name="Adding-Buttons"></a>
5512
Next: <a rel="next" accesskey="n" href="#More-Customizations">More Customizations</a>,
5513
Previous: <a rel="previous" accesskey="p" href="#Icons">Icons</a>,
5514
Up: <a rel="up" accesskey="u" href="#Customizing-Windows">Customizing Windows</a>
6562
5515
</small>
6563
5516
6564
<br>
5517
6565
5518
</div>
6566
5519
6567
<h5 class="subsubsection">Adding Buttons</h5>
5520
<h5 class="subsubsection">3.6.4.7 Adding Buttons</h5>
6568
5521
6569
<p>You can extend <small>DDD</small> with new buttons. See <a href="#Defining%20Buttons">Defining Buttons</a>,
5522
<p>You can extend <acronym>DDD</acronym> with new buttons. See <a href="#Defining-Buttons">Defining Buttons</a>,
6570
5523
for details.
6571
5524
6572
5525
<div class="node">
6573
5526
<p><hr>
6574
<small class=header>
6575
Node:<a name="More%20Customizations">More Customizations</a>,
6576
Previous:<a rel="previous" accesskey="p" href="#Adding%20Buttons">Adding Buttons</a>,
6577
Up:<a rel="up" accesskey="u" href="#Customizing%20Windows">Customizing Windows</a>
5527
<a name="More-Customizations"></a>
5528
Previous: <a rel="previous" accesskey="p" href="#Adding-Buttons">Adding Buttons</a>,
5529
Up: <a rel="up" accesskey="u" href="#Customizing-Windows">Customizing Windows</a>
6578
5530
</small>
6579
5531
6580
<br>
5532
6581
5533
</div>
6582
5534
6583
<h5 class="subsubsection">More Customizations</h5>
5535
<h5 class="subsubsection">3.6.4.8 More Customizations</h5>
6584
5536
6585
<p>You can change just about any label, color, keyboard mapping, etc. by
6586
changing resources from the <code>Ddd</code> application defaults file which
6587
comes with the <small>DDD</small> source distribution. Here's how it works:
5537
<p><a name="index-Ddd-605"></a>You can change just about any label, color, keyboard mapping, etc. by
5538
changing resources from the <samp><span class="file">Ddd</span></samp> application defaults file which
5539
comes with the <acronym>DDD</acronym> source distribution. Here's how it works:
6588
5540
6589
5541
<ul>
6590
<li>Identify the appropriate resource in the <code>Ddd</code> file.
5542
<li>Identify the appropriate resource in the <samp><span class="file">Ddd</span></samp> file.
6591
5543
6592
<li>Copy the resource line to your <code>~/.ddd/init</code> file
5544
<li>Copy the resource line to your <samp><span class="file">~/.ddd/init</span></samp> file
6593
5545
and change it at will.
6594
5546
</ul>
6595
5547
6596
<p>See <a href="#Application%20Defaults">Application Defaults</a>, for details on the application-defaults
5548
<p>See <a href="#Application-Defaults">Application Defaults</a>, for details on the application-defaults
6597
5549
file.
6598
5550
6599
5551
<div class="node">
6600
5552
<p><hr>
6601
<small class=header>
6602
Node:<a name="Debugger%20Settings">Debugger Settings</a>,
6603
Previous:<a rel="previous" accesskey="p" href="#Customizing%20Windows">Customizing Windows</a>,
6604
Up:<a rel="up" accesskey="u" href="#Customizing">Customizing</a>
5553
<a name="Debugger-Settings"></a>
5554
Previous: <a rel="previous" accesskey="p" href="#Customizing-Windows">Customizing Windows</a>,
5555
Up: <a rel="up" accesskey="u" href="#Customizing">Customizing</a>
6605
5556
</small>
6606
5557
6607
<br>
5558
6608
5559
</div>
6609
5560
6610
<h4 class="subsection">Debugger Settings</h4>
5561
<h4 class="subsection">3.6.5 Debugger Settings</h4>
6611
5562
6612
<p>For most inferior debuggers, you can change their internal settings
6613
using <code>Edit => Settings</code>. Using the settings editor, you
5563
<p>For most inferior debuggers, you can change their internal settings
5564
using ‘<samp><span class="samp">Edit Settings</span></samp>’. Using the settings editor, you
6614
5565
can determine whether C++ names are to be demangled, how many array
6615
5566
elements are to print, and so on.
6616
5567
6617
<br><p>
5568
<pre class="sp">
5569
5570
</pre>
6618
5571
<div align="center"><img src="PICS/ddd-settings.jpg" alt="PICS/ddd-settings.jpg"></div>
6619
<br><p>
6620
<p>The capabilities of the settings editor depend on the capabilities of
6621
your inferior debugger. Clicking on <code>?</code> gives an an explanation on
6622
the specific item; the <small>GDB</small> documentation gives more details.
6623
6624
<p>Use <code>Edit => Undo</code> to undo changes. Clicking on
6625
<code>Reset</code> restores the most recently saved settings.
5572
<pre class="sp">
5573
5574
</pre>
5575
5576
The capabilities of the settings editor depend on the capabilities of
5577
your inferior debugger. Clicking on ‘<samp><span class="samp">?</span></samp>’ gives an an explanation on
5578
the specific item; the <acronym>GDB</acronym> documentation gives more details.
5579
5580
<p>Use ‘<samp><span class="samp">Edit Undo</span></samp>’ to undo changes. Clicking on
5581
‘<samp><span class="samp">Reset</span></samp>’ restores the most recently saved settings.
6626
5582
6627
5583
<p>Some debugger settings are insensitive and cannot be changed, because
6628
doing so would endanger <small>DDD</small> operation. See the
6629
<code>gdbInitCommands</code> and <code>dbxInitCommands</code> resources for details.
5584
doing so would endanger <acronym>DDD</acronym> operation. See the
5585
‘<samp><span class="samp">gdbInitCommands</span></samp>’ and ‘<samp><span class="samp">dbxInitCommands</span></samp>’ resources for details.
6630
5586
6631
5587
<p>All debugger settings (except source and object paths) are saved with
6632
<small>DDD</small> options.
5588
<acronym>DDD</acronym> options.
6633
5589
6634
5590
<div class="node">
6635
5591
<p><hr>
6636
<small class=header>
6637
Node:<a name="Navigating">Navigating</a>,
6638
Next:<a rel="next" accesskey="n" href="#Stopping">Stopping</a>,
6639
Previous:<a rel="previous" accesskey="p" href="#Windows">Windows</a>,
6640
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
5592
<a name="Navigating"></a>
5593
Next: <a rel="next" accesskey="n" href="#Stopping">Stopping</a>,
5594
Previous: <a rel="previous" accesskey="p" href="#Windows">Windows</a>,
5595
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
6641
5596
</small>
6642
5597
6643
<br>
5598
6644
5599
</div>
6645
5600
6646
<h2 class="chapter">Navigating through the Code</h2>
5601
<h2 class="chapter">4 Navigating through the Code</h2>
6647
5602
6648
<p>This chapter discusses how to access code from within <small>DDD</small>.
5603
<p>This chapter discusses how to access code from within <acronym>DDD</acronym>.
6649
5604
6650
5605
<ul class="menu">
6651
<li><a accesskey="1" href="#Compiling%20for%20Debugging">Compiling for Debugging</a>: Always use `-g' to compile.
6652
<li><a accesskey="2" href="#Opening%20Files">Opening Files</a>: How to open a program for debugging.
6653
<li><a accesskey="3" href="#Looking%20up%20Items">Looking up Items</a>: Searching files and functions.
6654
<li><a accesskey="4" href="#Customizing%20Source">Customizing Source</a>: Arranging the source window.
5606
<li><a accesskey="1" href="#Compiling-for-Debugging">Compiling for Debugging</a>: Always use `-g' to compile.
5607
<li><a accesskey="2" href="#Opening-Files">Opening Files</a>: How to open a program for debugging.
5608
<li><a accesskey="3" href="#Looking-up-Items">Looking up Items</a>: Searching files and functions.
5609
<li><a accesskey="4" href="#Customizing-Source">Customizing Source</a>: Arranging the source window.
6655
5610
</ul>
6656
5611
6657
5612
<div class="node">
6658
5613
<p><hr>
6659
<small class=header>
6660
Node:<a name="Compiling%20for%20Debugging">Compiling for Debugging</a>,
6661
Next:<a rel="next" accesskey="n" href="#Opening%20Files">Opening Files</a>,
6662
Up:<a rel="up" accesskey="u" href="#Navigating">Navigating</a>
5614
<a name="Compiling-for-Debugging"></a>
5615
Next: <a rel="next" accesskey="n" href="#Opening-Files">Opening Files</a>,
5616
Up: <a rel="up" accesskey="u" href="#Navigating">Navigating</a>
6663
5617
</small>
6664
5618
6665
<br>
5619
6666
5620
</div>
6667
5621
6668
<h3 class="section">Compiling for Debugging</h3>
5622
<h3 class="section">4.1 Compiling for Debugging</h3>
6669
5623
6670
<p>In order to debug a program effectively, you need to generate debugging
5624
<p>In order to debug a program effectively, you need to generate debugging
6671
5625
information when you compile it. This debugging information is stored
6672
5626
in the object file; it describes the data type of each variable or
6673
5627
function and the correspondence between source line numbers and
6674
addresses in the executable code.<a rel="footnote" href="#fn-9"><sup>9</sup></a>
5628
addresses in the executable code.<a rel="footnote" href="#fn-9" name="fnd-9"><sup>9</sup></a>
6675
5629
6676
<p>To request debugging information, specify the <code>-g</code> option when you
5630
<p>To request debugging information, specify the <samp><span class="option">-g</span></samp> option when you
6677
5631
run the compiler.
6678
5632
6679
<p>Many C compilers are unable to handle the <code>-g</code> and <code>-O</code>
5633
<p>Many C compilers are unable to handle the <samp><span class="option">-g</span></samp> and <samp><span class="option">-O</span></samp>
6680
5634
options together. Using those compilers, you cannot generate optimized
6681
5635
executables containing debugging information.
6682
5636
6683
<p><small>GCC</small>, the <small>GNU</small> C compiler, supports <code>-g</code> with or without
6684
<code>-O</code>, making it possible to debug optimized code. We recommend
6685
that you <em>always</em> use <code>-g</code> whenever you compile a program.
5637
<p><a name="index-GCC-606"></a><acronym>GCC</acronym>, the <acronym>GNU</acronym> C compiler, supports <samp><span class="option">-g</span></samp> with or without
5638
<samp><span class="option">-O</span></samp>, making it possible to debug optimized code. We recommend
5639
that you <em>always</em> use <samp><span class="option">-g</span></samp> whenever you compile a program.
6686
5640
You may think your program is correct, but there is no sense in pushing
6687
5641
your luck.
6688
5642
6689
<p>When you debug a program compiled with <code>-g -O</code>, remember that the
5643
<p><a name="index-Optimized-code_002c-debugging-607"></a><a name="index-Debugging-optimized-code-608"></a>When you debug a program compiled with <samp><span class="option">-g -O</span></samp>, remember that the
6690
5644
optimizer is rearranging your code; the debugger shows you what is
6691
5645
really there. Do not be too surprised when the execution path does not
6692
5646
exactly match your source file! An extreme example: if you define a
6693
variable, but never use it, <small>DDD</small> never sees that
6694
variable--because the compiler optimizes it out of existence.
5647
variable, but never use it, <acronym>DDD</acronym> never sees that
5648
variable—because the compiler optimizes it out of existence.
6695
5649
6696
5650
<div class="node">
6697
5651
<p><hr>
6698
<small class=header>
6699
Node:<a name="Opening%20Files">Opening Files</a>,
6700
Next:<a rel="next" accesskey="n" href="#Looking%20up%20Items">Looking up Items</a>,
6701
Previous:<a rel="previous" accesskey="p" href="#Compiling%20for%20Debugging">Compiling for Debugging</a>,
6702
Up:<a rel="up" accesskey="u" href="#Navigating">Navigating</a>
5652
<a name="Opening-Files"></a>
5653
Next: <a rel="next" accesskey="n" href="#Looking-up-Items">Looking up Items</a>,
5654
Previous: <a rel="previous" accesskey="p" href="#Compiling-for-Debugging">Compiling for Debugging</a>,
5655
Up: <a rel="up" accesskey="u" href="#Navigating">Navigating</a>
6703
5656
</small>
6704
5657
6705
<br>
5658
6706
5659
</div>
6707
5660
6708
<h3 class="section">Opening Files</h3>
5661
<h3 class="section">4.2 Opening Files</h3>
6709
5662
6710
<p>If you did not invoke <small>DDD</small> specifying a program to be debugged,
6711
you can use the <code>File</code> menu to open programs, core dumps and
5663
<p><a name="index-Files_002c-opening-609"></a>
5664
If you did not invoke <acronym>DDD</acronym> specifying a program to be debugged,
5665
you can use the ‘<samp><span class="samp">File</span></samp>’ menu to open programs, core dumps and
6712
5666
sources.
6713
5667
6714
5668
<ul class="menu">
6715
<li><a accesskey="1" href="#Opening%20Programs">Opening Programs</a>: How to open a program for debugging.
6716
<li><a accesskey="2" href="#Opening%20Core%20Dumps">Opening Core Dumps</a>: Analyze a previous crash.
6717
<li><a accesskey="3" href="#Opening%20Source%20Files">Opening Source Files</a>: Open a source file of the program.
6718
<li><a accesskey="4" href="#Filtering%20Files">Filtering Files</a>: <small>DDD</small> only lists matching files.
5669
<li><a accesskey="1" href="#Opening-Programs">Opening Programs</a>: How to open a program for debugging.
5670
<li><a accesskey="2" href="#Opening-Core-Dumps">Opening Core Dumps</a>: Analyze a previous crash.
5671
<li><a accesskey="3" href="#Opening-Source-Files">Opening Source Files</a>: Open a source file of the program.
5672
<li><a accesskey="4" href="#Filtering-Files">Filtering Files</a>: <acronym>DDD</acronym> only lists matching files.
6719
5673
</ul>
6720
5674
6721
5675
<div class="node">
6722
5676
<p><hr>
6723
<small class=header>
6724
Node:<a name="Opening%20Programs">Opening Programs</a>,
6725
Next:<a rel="next" accesskey="n" href="#Opening%20Core%20Dumps">Opening Core Dumps</a>,
6726
Up:<a rel="up" accesskey="u" href="#Opening%20Files">Opening Files</a>
5677
<a name="Opening-Programs"></a>
5678
Next: <a rel="next" accesskey="n" href="#Opening-Core-Dumps">Opening Core Dumps</a>,
5679
Up: <a rel="up" accesskey="u" href="#Opening-Files">Opening Files</a>
6727
5680
</small>
6728
5681
6729
<br>
5682
6730
5683
</div>
6731
5684
6732
<h4 class="subsection">Opening Programs</h4>
6733
6734
<p>To open a program to be debugged, select <code>File => Open
6735
Program</code>.<a rel="footnote" href="#fn-10"><sup>10</sup></a>
6736
Click on <code>Open</code> to open the program
6737
6738
<p>In <small>JDB</small>, select <code>File => Open Class</code> instead. This gives you
5685
<h4 class="subsection">4.2.1 Opening Programs</h4>
5686
5687
<p><a name="index-Program_002c-opening-610"></a><a name="index-Class_002c-opening-611"></a><a name="index-Open-Program-612"></a><a name="index-Open-613"></a>
5688
To open a program to be debugged, select ‘<samp><span class="samp">File Open
5689
Program</span></samp>’.<a rel="footnote" href="#fn-10" name="fnd-10"><sup>10</sup></a>
5690
Click on ‘<samp><span class="samp">Open</span></samp>’ to open the program
5691
5692
<p><a name="index-Open-Class-614"></a>In <acronym>JDB</acronym>, select ‘<samp><span class="samp">File Open Class</span></samp>’ instead. This gives you
6739
5693
a list of available classes to choose from.
6740
5694
6741
<br><p>
5695
<pre class="sp">
5696
5697
</pre>
6742
5698
<div align="center"><img src="PICS/ddd-open.jpg" alt="PICS/ddd-open.jpg"></div>
6743
<br><p>
6744
<p>To re-open a recently debugged program or class, select <code>File
6745
=> Open Recent</code> and choose a program or class from the list.
6746
6747
<p>If no sources are found, See <a href="#Source%20Path">Source Path</a>, for specifying source
5699
<pre class="sp">
5700
5701
</pre>
5702
5703
<a name="index-Open-Recent-615"></a>To re-open a recently debugged program or class, select ‘<samp><span class="samp">File
5704
Open Recent</span></samp>’ and choose a program or class from the list.
5705
5706
<p>If no sources are found, See <a href="#Source-Path">Source Path</a>, for specifying source
6748
5707
directories.
6749
5708
6750
5709
<div class="node">
6751
5710
<p><hr>
6752
<small class=header>
6753
Node:<a name="Opening%20Core%20Dumps">Opening Core Dumps</a>,
6754
Next:<a rel="next" accesskey="n" href="#Opening%20Source%20Files">Opening Source Files</a>,
6755
Previous:<a rel="previous" accesskey="p" href="#Opening%20Programs">Opening Programs</a>,
6756
Up:<a rel="up" accesskey="u" href="#Opening%20Files">Opening Files</a>
5711
<a name="Opening-Core-Dumps"></a>
5712
Next: <a rel="next" accesskey="n" href="#Opening-Source-Files">Opening Source Files</a>,
5713
Previous: <a rel="previous" accesskey="p" href="#Opening-Programs">Opening Programs</a>,
5714
Up: <a rel="up" accesskey="u" href="#Opening-Files">Opening Files</a>
6757
5715
</small>
6758
5716
6759
<br>
5717
6760
5718
</div>
6761
5719
6762
<h4 class="subsection">Opening Core Dumps</h4>
6763
6764
<p>If a previous run of the program has crashed and you want to find out
6765
why, you can have <small>DDD</small> examine its <dfn>core dump</dfn>.<a rel="footnote" href="#fn-11"><sup>11</sup></a>
6766
6767
<p>To open a core dump for the program, select <code>File => Open
6768
Core Dump</code>. Click on <code>Open</code> to open the core dump.
6769
6770
<p>Before <code>Open Core Dump</code>, you should first use <code>File =>
6771
Open Program</code> to specify the program that generated the core dump and to
5720
<h4 class="subsection">4.2.2 Opening Core Dumps</h4>
5721
5722
<p><a name="index-Core-dump_002c-opening-616"></a>
5723
If a previous run of the program has crashed and you want to find out
5724
why, you can have <acronym>DDD</acronym> examine its <dfn>core dump</dfn>.<a rel="footnote" href="#fn-11" name="fnd-11"><sup>11</sup></a>
5725
5726
<p><a name="index-Open-617"></a>To open a core dump for the program, select ‘<samp><span class="samp">File Open
5727
Core Dump</span></samp>’. Click on ‘<samp><span class="samp">Open</span></samp>’ to open the core dump.
5728
5729
<p>Before ‘<samp><span class="samp">Open Core Dump</span></samp>’, you should first use ‘<samp><span class="samp">File
5730
Open Program</span></samp>’ to specify the program that generated the core dump and to
6772
5731
load its symbol table.
6773
5732
6774
5733
<div class="node">
6775
5734
<p><hr>
6776
<small class=header>
6777
Node:<a name="Opening%20Source%20Files">Opening Source Files</a>,
6778
Next:<a rel="next" accesskey="n" href="#Filtering%20Files">Filtering Files</a>,
6779
Previous:<a rel="previous" accesskey="p" href="#Opening%20Core%20Dumps">Opening Core Dumps</a>,
6780
Up:<a rel="up" accesskey="u" href="#Opening%20Files">Opening Files</a>
5735
<a name="Opening-Source-Files"></a>
5736
Next: <a rel="next" accesskey="n" href="#Filtering-Files">Filtering Files</a>,
5737
Previous: <a rel="previous" accesskey="p" href="#Opening-Core-Dumps">Opening Core Dumps</a>,
5738
Up: <a rel="up" accesskey="u" href="#Opening-Files">Opening Files</a>
6781
5739
</small>
6782
5740
6783
<br>
5741
6784
5742
</div>
6785
5743
6786
<h4 class="subsection">Opening Source Files</h4>
5744
<h4 class="subsection">4.2.3 Opening Source Files</h4>
6787
5745
6788
<p>To open a source file of the debugged program, select <code>File
6789
=> Open Source</code>.
5746
<p><a name="index-Source-file_002c-opening-618"></a><a name="index-Open-Source-619"></a>
5747
To open a source file of the debugged program, select ‘<samp><span class="samp">File
5748
Open Source</span></samp>’.
6790
5749
6791
5750
<ul>
6792
<li>Using <small>GDB</small>, this gives you a list of the sources used for compiling your
5751
<li>Using <acronym>GDB</acronym>, this gives you a list of the sources used for compiling your
6793
5752
program.
6794
5753
6795
5754
<li>Using other inferior debuggers, this gives you a list of accessible
6796
5755
source files, which may or may not be related to your program.
6797
5756
</ul>
6798
5757
6799
<p>Click on <code>Open</code> to open the source file. See <a href="#Source%20Path">Source Path</a>, if no
5758
<p><a name="index-Open-620"></a>Click on ‘<samp><span class="samp">Open</span></samp>’ to open the source file. See <a href="#Source-Path">Source Path</a>, if no
6800
5759
sources are found.
6801
5760
6802
5761
<div class="node">
6803
5762
<p><hr>
6804
<small class=header>
6805
Node:<a name="Filtering%20Files">Filtering Files</a>,
6806
Previous:<a rel="previous" accesskey="p" href="#Opening%20Source%20Files">Opening Source Files</a>,
6807
Up:<a rel="up" accesskey="u" href="#Opening%20Files">Opening Files</a>
5763
<a name="Filtering-Files"></a>
5764
Previous: <a rel="previous" accesskey="p" href="#Opening-Source-Files">Opening Source Files</a>,
5765
Up: <a rel="up" accesskey="u" href="#Opening-Files">Opening Files</a>
6808
5766
</small>
6809
5767
6810
<br>
5768
6811
5769
</div>
6812
5770
6813
<h4 class="subsection">Filtering Files</h4>
5771
<h4 class="subsection">4.2.4 Filtering Files</h4>
6814
5772
6815
<p>When presenting files to be opened, <small>DDD</small> by default filters files
5773
<p>When presenting files to be opened, <acronym>DDD</acronym> by default filters files
6816
5774
when opening execution files, core dumps, or source files, such that the
6817
selection shows only suitable files. This requires that <small>DDD</small>
6818
opens each file, which may take time. See <a href="#Customizing%20File%20Filtering">Customizing File Filtering</a>, if you want to turn off this feature.
5775
selection shows only suitable files. This requires that <acronym>DDD</acronym>
5776
opens each file, which may take time. See <a href="#Customizing-File-Filtering">Customizing File Filtering</a>, if you want to turn off this feature.
6819
5777
6820
5778
<div class="node">
6821
5779
<p><hr>
6822
<small class=header>
6823
Node:<a name="Looking%20up%20Items">Looking up Items</a>,
6824
Next:<a rel="next" accesskey="n" href="#Customizing%20Source">Customizing Source</a>,
6825
Previous:<a rel="previous" accesskey="p" href="#Opening%20Files">Opening Files</a>,
6826
Up:<a rel="up" accesskey="u" href="#Navigating">Navigating</a>
5780
<a name="Looking-up-Items"></a>
5781
Next: <a rel="next" accesskey="n" href="#Customizing-Source">Customizing Source</a>,
5782
Previous: <a rel="previous" accesskey="p" href="#Opening-Files">Opening Files</a>,
5783
Up: <a rel="up" accesskey="u" href="#Navigating">Navigating</a>
6827
5784
</small>
6828
5785
6829
<br>
5786
6830
5787
</div>
6831
5788
6832
<h3 class="section">Looking up Items</h3>
5789
<h3 class="section">4.3 Looking up Items</h3>
6833
5790
6834
<p>As soon as the source of the debugged program is available, the
6835
<em>source window</em> displays its current source text. (see <a href="#Source%20Path">Source Path</a>, if a source text cannot be found.)
5791
<p>As soon as the source of the debugged program is available, the
5792
<em>source window</em> displays its current source text. (see <a href="#Source-Path">Source Path</a>, if a source text cannot be found.)
6836
5793
6837
5794
<p>In the source window, you can lookup and examine function and variable
6838
5795
definitions as well as search for arbitrary occurrences in the source
6839
5796
text.
6840
5797
6841
5798
<ul class="menu">
6842
<li><a accesskey="1" href="#Looking%20up%20Definitions">Looking up Definitions</a>: Jump towards a specific item.
6843
<li><a accesskey="2" href="#Textual%20Search">Textual Search</a>: Search within the current source.
6844
<li><a accesskey="3" href="#Looking%20up%20Previous%20Locations">Looking up Previous Locations</a>: Navigate back and forth.
6845
<li><a accesskey="4" href="#Source%20Path">Source Path</a>: Make <small>DDD</small> know where to search.
5799
<li><a accesskey="1" href="#Looking-up-Definitions">Looking up Definitions</a>: Jump towards a specific item.
5800
<li><a accesskey="2" href="#Textual-Search">Textual Search</a>: Search within the current source.
5801
<li><a accesskey="3" href="#Looking-up-Previous-Locations">Looking up Previous Locations</a>: Navigate back and forth.
5802
<li><a accesskey="4" href="#Source-Path">Source Path</a>: Make <acronym>DDD</acronym> know where to search.
6846
5803
</ul>
6847
5804
6848
5805
<div class="node">
6849
5806
<p><hr>
6850
<small class=header>
6851
Node:<a name="Looking%20up%20Definitions">Looking up Definitions</a>,
6852
Next:<a rel="next" accesskey="n" href="#Textual%20Search">Textual Search</a>,
6853
Up:<a rel="up" accesskey="u" href="#Looking%20up%20Items">Looking up Items</a>
5807
<a name="Looking-up-Definitions"></a>
5808
Next: <a rel="next" accesskey="n" href="#Textual-Search">Textual Search</a>,
5809
Up: <a rel="up" accesskey="u" href="#Looking-up-Items">Looking up Items</a>
6854
5810
</small>
6855
5811
6856
<br>
5812
6857
5813
</div>
6858
5814
6859
<h4 class="subsection">Looking up Definitions</h4>
5815
<h4 class="subsection">4.3.1 Looking up Definitions</h4>
6860
5816
6861
<p>If you wish to lookup a specific function or variable definition whose
5817
<p><a name="index-Lookup-621"></a>
5818
If you wish to lookup a specific function or variable definition whose
6862
5819
name is visible in the source text, click with <em>mouse button 1</em> on
6863
5820
the function or variable name. The name is copied to the argument
6864
field. Change the name if desired and click on the <code>Lookup</code> button
5821
field. Change the name if desired and click on the ‘<samp><span class="samp">Lookup</span></samp>’ button
6865
5822
to find its definition.
6866
5823
6867
<br><p>
5824
<pre class="sp">
5825
5826
</pre>
6868
5827
<div align="center"><img src="PICS/ddd-source-popup.jpg" alt="PICS/ddd-source-popup.jpg"></div>
6869
<br><p>
6870
<p>As a faster alternative, you can simply press <em>mouse button 3</em> on the
6871
function name and select the <code>Lookup</code> item from the source popup
5828
<pre class="sp">
5829
5830
</pre>
5831
5832
As a faster alternative, you can simply press <em>mouse button 3</em> on the
5833
function name and select the ‘<samp><span class="samp">Lookup</span></samp>’ item from the source popup
6872
5834
menu.
6873
5835
6874
5836
<p>As an even faster alternative, you can also double-click on a function
6875
call (an identifier followed by a <code>(</code> character) to lookup the
5837
call (an identifier followed by a ‘<samp><span class="samp">(</span></samp>’ character) to lookup the
6876
5838
function definition.
6877
5839
6878
<p>If a source file is not found, See <a href="#Source%20Path">Source Path</a>, for specifying source
5840
<p>If a source file is not found, See <a href="#Source-Path">Source Path</a>, for specifying source
6879
5841
directories.
6880
5842
6881
5843
<div class="node">
6882
5844
<p><hr>
6883
<small class=header>
6884
Node:<a name="Textual%20Search">Textual Search</a>,
6885
Next:<a rel="next" accesskey="n" href="#Looking%20up%20Previous%20Locations">Looking up Previous Locations</a>,
6886
Previous:<a rel="previous" accesskey="p" href="#Looking%20up%20Definitions">Looking up Definitions</a>,
6887
Up:<a rel="up" accesskey="u" href="#Looking%20up%20Items">Looking up Items</a>
5845
<a name="Textual-Search"></a>
5846
Next: <a rel="next" accesskey="n" href="#Looking-up-Previous-Locations">Looking up Previous Locations</a>,
5847
Previous: <a rel="previous" accesskey="p" href="#Looking-up-Definitions">Looking up Definitions</a>,
5848
Up: <a rel="up" accesskey="u" href="#Looking-up-Items">Looking up Items</a>
6888
5849
</small>
6889
5850
6890
<br>
5851
6891
5852
</div>
6892
5853
6893
<h4 class="subsection">Textual Search</h4>
5854
<h4 class="subsection">4.3.2 Textual Search</h4>
6894
5855
6895
<p>If the item you wish to search is visible in the source text, click with
5856
<p><a name="index-Find-_003e_003e-622"></a><a name="index-Find-_003c_003c-623"></a>
5857
If the item you wish to search is visible in the source text, click with
6896
5858
<em>mouse button 1</em> on it. The identifier is copied to the argument
6897
field. Click on the <code>Find >></code> button to find following occurrences
6898
and on <code>Find >> => Find << ()</code> to find previous occurrences.
5859
field. Click on the ‘<samp><span class="samp">Find >></span></samp>’ button to find following occurrences
5860
and on ‘<samp><span class="samp">Find >> Find << ()</span></samp>’ to find previous occurrences.
6899
5861
6900
<p>By default, <small>DDD</small> finds only complete words. To search for
6901
arbitrary substrings, change the value of the <code>Source =>
6902
Find Words Only</code> option.
5862
<p><a name="index-Find-Words-Only-624"></a>By default, <acronym>DDD</acronym> finds only complete words. To search for
5863
arbitrary substrings, change the value of the ‘<samp><span class="samp">Source
5864
Find Words Only</span></samp>’ option.
6903
5865
6904
5866
<div class="node">
6905
5867
<p><hr>
6906
<small class=header>
6907
Node:<a name="Looking%20up%20Previous%20Locations">Looking up Previous Locations</a>,
6908
Next:<a rel="next" accesskey="n" href="#Source%20Path">Source Path</a>,
6909
Previous:<a rel="previous" accesskey="p" href="#Textual%20Search">Textual Search</a>,
6910
Up:<a rel="up" accesskey="u" href="#Looking%20up%20Items">Looking up Items</a>
5868
<a name="Looking-up-Previous-Locations"></a>
5869
Next: <a rel="next" accesskey="n" href="#Source-Path">Source Path</a>,
5870
Previous: <a rel="previous" accesskey="p" href="#Textual-Search">Textual Search</a>,
5871
Up: <a rel="up" accesskey="u" href="#Looking-up-Items">Looking up Items</a>
6911
5872
</small>
6912
5873
6913
<br>
5874
6914
5875
</div>
6915
5876
6916
<h4 class="subsection">Looking up Previous Locations</h4>
5877
<h4 class="subsection">4.3.3 Looking up Previous Locations</h4>
6917
5878
6918
<p>After looking up a location, use <code>Edit => Undo</code> (or the
6919
<code>Undo</code> button on the command tool) to go back to the original
6920
locations. <code>Edit => Redo</code> brings you back again to the
5879
<p><a name="index-Undo-625"></a><a name="index-Redo-626"></a><a name="index-Undoing-lookups-627"></a><a name="index-Redoing-lookups-628"></a><a name="index-Lookups_002c-undoing-629"></a><a name="index-Lookups_002c-redoing-630"></a>
5880
After looking up a location, use ‘<samp><span class="samp">Edit Undo</span></samp>’ (or the
5881
‘<samp><span class="samp">Undo</span></samp>’ button on the command tool) to go back to the original
5882
locations. ‘<samp><span class="samp">Edit Redo</span></samp>’ brings you back again to the
6921
5883
location you looked for.
6922
5884
6923
<br><p>
5885
<pre class="sp">
5886
5887
</pre>
6924
5888
<div align="center"><img src="PICS/ddd-source.jpg" alt="PICS/ddd-source.jpg"></div>
6925
<br><p>
5889
<pre class="sp">
5890
5891
</pre>
5892
6926
5893
<div class="node">
6927
5894
<p><hr>
6928
<small class=header>
6929
Node:<a name="Source%20Path">Source Path</a>,
6930
Previous:<a rel="previous" accesskey="p" href="#Looking%20up%20Previous%20Locations">Looking up Previous Locations</a>,
6931
Up:<a rel="up" accesskey="u" href="#Looking%20up%20Items">Looking up Items</a>
5895
<a name="Source-Path"></a>
5896
Previous: <a rel="previous" accesskey="p" href="#Looking-up-Previous-Locations">Looking up Previous Locations</a>,
5897
Up: <a rel="up" accesskey="u" href="#Looking-up-Items">Looking up Items</a>
6932
5898
</small>
6933
5899
6934
<br>
5900
6935
5901
</div>
6936
5902
6937
<h4 class="subsection">Specifying Source Directories</h4>
5903
<h4 class="subsection">4.3.4 Specifying Source Directories</h4>
6938
5904
6939
<p>Executable programs sometimes do not record the directories of the
5905
<p><a name="index-Source_002c-accessing-631"></a><a name="index-Source-directory-632"></a>
5906
Executable programs sometimes do not record the directories of the
6940
5907
source files from which they were compiled, just the names. Even when
6941
5908
they do, the directories could be moved between the compilation and your
6942
5909
debugging session.
6943
5910
6944
<p>Here's how <small>GDB</small> accesses source files; other inferior debuggers have
5911
<p>Here's how <acronym>GDB</acronym> accesses source files; other inferior debuggers have
6945
5912
similar methods.
6946
5913
6947
<p><small>GDB</small> has a list of directories to search for source files; this is called
6948
the <dfn>source path</dfn>. Each time <small>GDB</small> wants a source file, it tries all
5914
<p><a name="index-Source-path-633"></a><acronym>GDB</acronym> has a list of directories to search for source files; this is called
5915
the <dfn>source path</dfn>. Each time <acronym>GDB</acronym> wants a source file, it tries all
6949
5916
the directories in the list, in the order they are present in the list,
6950
5917
until it finds a file with the desired name. Note that the executable
6951
5918
search path is <em>not</em> used for this purpose. Neither is the current
6952
5919
working directory, unless it happens to be in the source path.
6953
5920
6954
<p>If <small>GDB</small> cannot find a source file in the source path, and the object
6955
program records a directory, <small>GDB</small> tries that directory too. If the
5921
<p>If <acronym>GDB</acronym> cannot find a source file in the source path, and the object
5922
program records a directory, <acronym>GDB</acronym> tries that directory too. If the
6956
5923
source path is empty, and there is no record of the compilation
6957
directory, <small>GDB</small> looks in the current directory as a last resort.
6958
6959
<p>To specify a source path for your inferior debugger, use <code>Edit
6960
=> Debugger Settings</code> (see <a href="#Debugger%20Settings">Debugger Settings</a> and search for
6961
appropriate entries (in <small>GDB</small>, this is <code>Search path for source
6962
files</code>).
6963
6964
<p>If <code>Debugger Settings</code> has no suitable entry, you can also specify
6965
a source path for the inferior debugger when invoking <small>DDD</small>.
6966
See <a href="#Inferior%20Debugger%20Options">Inferior Debugger Options</a>, for details.
6967
6968
<p>When using <small>JDB</small>, you can set the <code>CLASSPATH</code> environment variable to
6969
specify directories where <small>JDB</small> (and <small>DDD</small>) should search for
5924
directory, <acronym>GDB</acronym> looks in the current directory as a last resort.
5925
5926
<p><a name="index-Search-path-for-source-files-634"></a><a name="index-Source-path_002c-specifying-635"></a>To specify a source path for your inferior debugger, use ‘<samp><span class="samp">Edit
5927
Debugger Settings</span></samp>’ (see <a href="#Debugger-Settings">Debugger Settings</a> and search for
5928
appropriate entries (in <acronym>GDB</acronym>, this is ‘<samp><span class="samp">Search path for source
5929
files</span></samp>’).
5930
5931
<p>If ‘<samp><span class="samp">Debugger Settings</span></samp>’ has no suitable entry, you can also specify
5932
a source path for the inferior debugger when invoking <acronym>DDD</acronym>.
5933
See <a href="#Inferior-Debugger-Options">Inferior Debugger Options</a>, for details.
5934
5935
<p><a name="index-CLASSPATH-636"></a>When using <acronym>JDB</acronym>, you can set the <samp><span class="env">CLASSPATH</span></samp> environment variable to
5936
specify directories where <acronym>JDB</acronym> (and <acronym>DDD</acronym>) should search for
6970
5937
classes.
6971
5938
6972
5939
<p>If DDD does not find a source file for any reason, check the
6976
5943
<li>In order to debug a program effectively, you need to generate debugging
6977
5944
information when you compile it. Without debugging information, the
6978
5945
inferior debugger will be unable to locate the source code. To request
6979
debugging information, specify the <code>-g</code> option when you run the
6980
compiler. See <a href="#Compiling%20for%20Debugging">Compiling for Debugging</a>, for details.
5946
debugging information, specify the <samp><span class="option">-g</span></samp> option when you run the
5947
compiler. See <a href="#Compiling-for-Debugging">Compiling for Debugging</a>, for details.
6981
5948
6982
5949
<li>You may need to tell your inferior debugger where the source code files
6983
are. See <a href="#Source%20Path">Source Path</a>, for details.
5950
are. See <a href="#Source-Path">Source Path</a>, for details.
6984
5951
6985
<p>Using <small>GDB</small>, you can also create a local <code>.gdbinit</code> file that
6986
contains a line <code>directory </code><var>path</var><code></code>. Here, <var>path</var> is a
5952
<p><a name="index-directory-637"></a>Using <acronym>GDB</acronym>, you can also create a local <samp><span class="file">.gdbinit</span></samp> file that
5953
contains a line <samp><span class="command">directory </span><var>path</var></samp>. Here, <var>path</var> is a
6987
5954
colon-separated list of source paths.
6988
5955
</ul>
6989
5956
6990
5957
<div class="node">
6991
5958
<p><hr>
6992
<small class=header>
6993
Node:<a name="Customizing%20Source">Customizing Source</a>,
6994
Previous:<a rel="previous" accesskey="p" href="#Looking%20up%20Items">Looking up Items</a>,
6995
Up:<a rel="up" accesskey="u" href="#Navigating">Navigating</a>
5959
<a name="Customizing-Source"></a>
5960
Previous: <a rel="previous" accesskey="p" href="#Looking-up-Items">Looking up Items</a>,
5961
Up: <a rel="up" accesskey="u" href="#Navigating">Navigating</a>
6996
5962
</small>
6997
5963
6998
<br>
5964
6999
5965
</div>
7000
5966
7001
<h3 class="section">Customizing the Source Window</h3>
7002
7003
<p>The source window can be customized in a number of ways, most of them
7004
accessed via <code>Edit => Preferences => Source</code>.
7005
7006
<br><p>
5967
<h3 class="section">4.4 Customizing the Source Window</h3>
5968
5969
<p>The source window can be customized in a number of ways, most of them
5970
accessed via ‘<samp><span class="samp">Edit Preferences Source</span></samp>’.
5971
5972
<pre class="sp">
5973
5974
</pre>
7007
5975
<div align="center"><img src="PICS/ddd-source-prefs.jpg" alt="PICS/ddd-source-prefs.jpg"></div>
7008
<br><p>
5976
<pre class="sp">
5977
5978
</pre>
5979
7009
5980
<ul class="menu">
7010
<li><a accesskey="1" href="#Customizing%20Glyphs">Customizing Glyphs</a>:
7011
<li><a accesskey="2" href="#Customizing%20Searching">Customizing Searching</a>:
7012
<li><a accesskey="3" href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>:
7013
<li><a accesskey="4" href="#Customizing%20Source%20Scrolling">Customizing Source Scrolling</a>:
7014
<li><a accesskey="5" href="#Customizing%20Source%20Lookup">Customizing Source Lookup</a>:
7015
<li><a accesskey="6" href="#Customizing%20File%20Filtering">Customizing File Filtering</a>:
5981
<li><a accesskey="1" href="#Customizing-Glyphs">Customizing Glyphs</a>
5982
<li><a accesskey="2" href="#Customizing-Searching">Customizing Searching</a>
5983
<li><a accesskey="3" href="#Customizing-Source-Appearance">Customizing Source Appearance</a>
5984
<li><a accesskey="4" href="#Customizing-Source-Scrolling">Customizing Source Scrolling</a>
5985
<li><a accesskey="5" href="#Customizing-Source-Lookup">Customizing Source Lookup</a>
5986
<li><a accesskey="6" href="#Customizing-File-Filtering">Customizing File Filtering</a>
7016
5987
</ul>
7017
5988
7018
5989
<div class="node">
7019
5990
<p><hr>
7020
<small class=header>
7021
Node:<a name="Customizing%20Glyphs">Customizing Glyphs</a>,
7022
Next:<a rel="next" accesskey="n" href="#Customizing%20Searching">Customizing Searching</a>,
7023
Up:<a rel="up" accesskey="u" href="#Customizing%20Source">Customizing Source</a>
5991
<a name="Customizing-Glyphs"></a>
5992
Next: <a rel="next" accesskey="n" href="#Customizing-Searching">Customizing Searching</a>,
5993
Up: <a rel="up" accesskey="u" href="#Customizing-Source">Customizing Source</a>
7024
5994
</small>
7025
5995
7026
<br>
5996
7027
5997
</div>
7028
5998
7029
<h4 class="subsection">Customizing Glyphs</h4>
5999
<h4 class="subsection">4.4.1 Customizing Glyphs</h4>
7030
6000
7031
<p>In the source text, the current execution position and breakpoints are
7032
indicated by symbols (<dfn>glyphs</dfn>). As an alternative, <small>DDD</small> can
6001
<p><a name="index-Glyph-638"></a><a name="index-Show-Position-and-Breakpoints-639"></a>In the source text, the current execution position and breakpoints are
6002
indicated by symbols (<dfn>glyphs</dfn>). As an alternative, <acronym>DDD</acronym> can
7033
6003
also indicate these positions using text characters. If you wish to
7034
disable glyphs, set <code>Edit => Preferences => Source
7035
=> Show Position and Breakpoints => as Text Characters</code>
7036
option. This also makes <small>DDD</small> run slightly faster, especially
6004
disable glyphs, set ‘<samp><span class="samp">Edit Preferences Source
6005
Show Position and Breakpoints as Text Characters</span></samp>’
6006
option. This also makes <acronym>DDD</acronym> run slightly faster, especially
7037
6007
when scrolling.
7038
6008
7039
6009
<p>This setting is tied to this resource:
7040
6010
7041
<p>
7042
<table width="100%">
7043
<tr>
7044
<td align="left"><b>displayGlyphs</b><i> </i>(<i>class DisplayGlyphs</i>)<i>
7045
</i></td>
7046
<td align="right">Resource</td>
7047
</tr>
7048
</table>
7049
<table width="95%" align="center">
7050
<tr><td>
7051
If this is <code>on</code>, the current execution position and breakpoints are
6011
<div class="defun">
6012
— Resource: <b>displayGlyphs</b> (<var>class DisplayGlyphs</var>)<var><a name="index-displayGlyphs-640"></a></var><br>
6013
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’, the current execution position and breakpoints are
7052
6014
displayed as glyphs; otherwise, they are shown through characters in the
7053
text. The default is <code>on</code>. See <a href="#Options">Options</a>, for the
7054
<code>--glyphs</code> and <code>--no-glyphs</code> options.
7055
</td></tr>
7056
</table>
6015
text. The default is ‘<samp><span class="samp">on</span></samp>’. See <a href="#Options">Options</a>, for the
6016
<samp><span class="option">--glyphs</span></samp> and <samp><span class="option">--no-glyphs</span></samp> options.
6017
</p></blockquote></div>
7057
6018
7058
6019
<p>You can further control glyphs using the following resources:
7059
6020
7060
<p>
7061
<table width="100%">
7062
<tr>
7063
<td align="left"><b>cacheGlyphImages</b><i> </i>(<i>class CacheMachineCode</i>)<i>
7064
</i></td>
7065
<td align="right">Resource</td>
7066
</tr>
7067
</table>
7068
<table width="95%" align="center">
7069
<tr><td>
7070
Whether to cache (share) glyph images (<code>on</code>) or not (<code>off</code>).
6021
<div class="defun">
6022
— Resource: <b>cacheGlyphImages</b> (<var>class CacheMachineCode</var>)<var><a name="index-cacheGlyphImages-641"></a></var><br>
6023
<blockquote><p>Whether to cache (share) glyph images (‘<samp><span class="samp">on</span></samp>’) or not (‘<samp><span class="samp">off</span></samp>’).
7071
6024
Caching glyph images requires less X resources, but has been reported to
7072
fail with OSF/Motif 2.1 on XFree86 servers. Default is <code>off</code> for
7073
OSF/Motif 2.1 or later on <small>GNU</small>/Linux machines, and <code>on</code>
6025
fail with OSF/Motif 2.1 on XFree86 servers. Default is ‘<samp><span class="samp">off</span></samp>’ for
6026
OSF/Motif 2.1 or later on <acronym>GNU</acronym>/Linux machines, and ‘<samp><span class="samp">on</span></samp>’
7074
6027
otherwise.
7075
</td></tr>
7076
</table>
6028
</p></blockquote></div>
7077
6029
7078
<p>
7079
<table width="100%">
7080
<tr>
7081
<td align="left"><b>glyphUpdateDelay</b><i> </i>(<i>class GlyphUpdateDelay</i>)<i>
7082
</i></td>
7083
<td align="right">Resource</td>
7084
</tr>
7085
</table>
7086
<table width="95%" align="center">
7087
<tr><td>
7088
A delay (in ms) that says how much time to wait before updating glyphs
6030
<div class="defun">
6031
— Resource: <b>glyphUpdateDelay</b> (<var>class GlyphUpdateDelay</var>)<var><a name="index-glyphUpdateDelay-642"></a></var><br>
6032
<blockquote><p>A delay (in ms) that says how much time to wait before updating glyphs
7089
6033
while scrolling the source text. A small value results in glyphs
7090
6034
being scrolled with the text, a large value disables glyphs while
7091
6035
scrolling and makes scrolling faster. Default: <code>10</code>.
7092
</td></tr>
7093
</table>
6036
</p></blockquote></div>
7094
6037
7095
<p>
7096
<table width="100%">
7097
<tr>
7098
<td align="left"><b>maxGlyphs</b><i> </i>(<i>class MaxGlyphs</i>)<i>
7099
</i></td>
7100
<td align="right">Resource</td>
7101
</tr>
7102
</table>
7103
<table width="95%" align="center">
7104
<tr><td>
7105
The maximum number of glyphs to be displayed (default: <code>10</code>).
6038
<div class="defun">
6039
— Resource: <b>maxGlyphs</b> (<var>class MaxGlyphs</var>)<var><a name="index-maxGlyphs-643"></a></var><br>
6040
<blockquote><p>The maximum number of glyphs to be displayed (default: <code>10</code>).
7106
6041
Raising this value causes more glyphs to be allocated, possibly
7107
6042
wasting resources that are never needed.
7108
</td></tr>
7109
</table>
6043
</p></blockquote></div>
7110
6044
7111
6045
<div class="node">
7112
6046
<p><hr>
7113
<small class=header>
7114
Node:<a name="Customizing%20Searching">Customizing Searching</a>,
7115
Next:<a rel="next" accesskey="n" href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>,
7116
Previous:<a rel="previous" accesskey="p" href="#Customizing%20Glyphs">Customizing Glyphs</a>,
7117
Up:<a rel="up" accesskey="u" href="#Customizing%20Source">Customizing Source</a>
6047
<a name="Customizing-Searching"></a>
6048
Next: <a rel="next" accesskey="n" href="#Customizing-Source-Appearance">Customizing Source Appearance</a>,
6049
Previous: <a rel="previous" accesskey="p" href="#Customizing-Glyphs">Customizing Glyphs</a>,
6050
Up: <a rel="up" accesskey="u" href="#Customizing-Source">Customizing Source</a>
7118
6051
</small>
7119
6052
7120
<br>
6053
7121
6054
</div>
7122
6055
7123
<h4 class="subsection">Customizing Searching</h4>
7124
7125
<p>Searching in the source text (see <a href="#Textual%20Search">Textual Search</a>) is controlled by
7126
these resources, changed via the <code>Source</code> menu:
7127
7128
<p>
7129
<table width="100%">
7130
<tr>
7131
<td align="left"><b>findCaseSensitive</b><i> </i>(<i>class FindCaseSensitive</i>)<i>
7132
</i></td>
7133
<td align="right">Resource</td>
7134
</tr>
7135
</table>
7136
<table width="95%" align="center">
7137
<tr><td>
7138
If this is <code>on</code> (default), the <code>Find</code> commands are
6056
<h4 class="subsection">4.4.2 Customizing Searching</h4>
6057
6058
<p>Searching in the source text (see <a href="#Textual-Search">Textual Search</a>) is controlled by
6059
these resources, changed via the ‘<samp><span class="samp">Source</span></samp>’ menu:
6060
6061
<div class="defun">
6062
— Resource: <b>findCaseSensitive</b> (<var>class FindCaseSensitive</var>)<var><a name="index-findCaseSensitive-644"></a></var><br>
6063
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’ (default), the ‘<samp><span class="samp">Find</span></samp>’ commands are
7139
6064
case-sensitive. Otherwise, occurrences are found regardless of case.
7140
</td></tr>
7141
</table>
6065
</p></blockquote></div>
7142
6066
7143
<p>
7144
<table width="100%">
7145
<tr>
7146
<td align="left"><b>findWordsOnly</b><i> </i>(<i>class FindWordsOnly</i>)<i>
7147
</i></td>
7148
<td align="right">Resource</td>
7149
</tr>
7150
</table>
7151
<table width="95%" align="center">
7152
<tr><td>
7153
If this is <code>on</code> (default), the <code>Find</code> commands find
6067
<div class="defun">
6068
— Resource: <b>findWordsOnly</b> (<var>class FindWordsOnly</var>)<var><a name="index-findWordsOnly-645"></a></var><br>
6069
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’ (default), the ‘<samp><span class="samp">Find</span></samp>’ commands find
7154
6070
complete words only. Otherwise, arbitrary occurrences are found.
7155
</td></tr>
7156
</table>
6071
</p></blockquote></div>
7157
6072
7158
6073
<div class="node">
7159
6074
<p><hr>
7160
<small class=header>
7161
Node:<a name="Customizing%20Source%20Appearance">Customizing Source Appearance</a>,
7162
Next:<a rel="next" accesskey="n" href="#Customizing%20Source%20Scrolling">Customizing Source Scrolling</a>,
7163
Previous:<a rel="previous" accesskey="p" href="#Customizing%20Searching">Customizing Searching</a>,
7164
Up:<a rel="up" accesskey="u" href="#Customizing%20Source">Customizing Source</a>
6075
<a name="Customizing-Source-Appearance"></a>
6076
Next: <a rel="next" accesskey="n" href="#Customizing-Source-Scrolling">Customizing Source Scrolling</a>,
6077
Previous: <a rel="previous" accesskey="p" href="#Customizing-Searching">Customizing Searching</a>,
6078
Up: <a rel="up" accesskey="u" href="#Customizing-Source">Customizing Source</a>
7165
6079
</small>
7166
6080
7167
<br>
6081
7168
6082
</div>
7169
6083
7170
<h4 class="subsection">Customizing Source Appearance</h4>
7171
7172
<p>You can have <small>DDD</small> show line numbers within the source window.
7173
Use <code>Edit => Preferences => Source => Display
7174
Source Line Numbers</code>.
7175
7176
<p>
7177
<table width="100%">
7178
<tr>
7179
<td align="left"><b>displayLineNumbers</b><i> </i>(<i>class DisplayLineNumbers</i>)<i>
7180
</i></td>
7181
<td align="right">Resource</td>
7182
</tr>
7183
</table>
7184
<table width="95%" align="center">
7185
<tr><td>
7186
If this is <code>on</code>, lines in the source text are prefixed with
7187
their respective line number. The default is <code>off</code>.
7188
</td></tr>
7189
</table>
7190
7191
<p>You can instruct <small>DDD</small> to indent the source code, leaving more
6084
<h4 class="subsection">4.4.3 Customizing Source Appearance</h4>
6085
6086
<p><a name="index-Line-numbers-646"></a><a name="index-Display-Source-Line-Numbers-647"></a>You can have <acronym>DDD</acronym> show line numbers within the source window.
6087
Use ‘<samp><span class="samp">Edit Preferences Source Display
6088
Source Line Numbers</span></samp>’.
6089
6090
<div class="defun">
6091
— Resource: <b>displayLineNumbers</b> (<var>class DisplayLineNumbers</var>)<var><a name="index-displayLineNumbers-648"></a></var><br>
6092
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’, lines in the source text are prefixed with
6093
their respective line number. The default is ‘<samp><span class="samp">off</span></samp>’.
6094
</p></blockquote></div>
6095
6096
<p><a name="index-Indent_002c-source-code-649"></a><a name="index-Source-indentation-650"></a>You can instruct <acronym>DDD</acronym> to indent the source code, leaving more
7192
6097
room for breakpoints and execution glyphs. This is done using the
7193
<code>Edit => Preferences => Source => Source
7194
indentation</code> slider. The default value is <code>0</code> for no indentation
6098
‘<samp><span class="samp">Edit Preferences Source Source
6099
indentation</span></samp>’ slider. The default value is <code>0</code> for no indentation
7195
6100
at all.
7196
6101
7197
<p>
7198
<table width="100%">
7199
<tr>
7200
<td align="left"><b>indentSource</b><i> </i>(<i>class Indent</i>)<i>
7201
</i></td>
7202
<td align="right">Resource</td>
7203
</tr>
7204
</table>
7205
<table width="95%" align="center">
7206
<tr><td>
7207
The number of columns to indent the source code, such that there is
6102
<div class="defun">
6103
— Resource: <b>indentSource</b> (<var>class Indent</var>)<var><a name="index-indentSource-651"></a></var><br>
6104
<blockquote><p>The number of columns to indent the source code, such that there is
7208
6105
enough place to display breakpoint locations. Default: <code>0</code>.
7209
</td></tr>
7210
</table>
7211
7212
<p>By default, <small>DDD</small> uses a minimum indentation for script languages.
7213
7214
<p>
7215
<table width="100%">
7216
<tr>
7217
<td align="left"><b>indentScript</b><i> </i>(<i>class Indent</i>)<i>
7218
</i></td>
7219
<td align="right">Resource</td>
7220
</tr>
7221
</table>
7222
<table width="95%" align="center">
7223
<tr><td>
7224
The minimum indentation for script languages, such as Perl, Python, and
6106
</p></blockquote></div>
6107
6108
<p>By default, <acronym>DDD</acronym> uses a minimum indentation for script languages.
6109
6110
<div class="defun">
6111
— Resource: <b>indentScript</b> (<var>class Indent</var>)<var><a name="index-indentScript-652"></a></var><br>
6112
<blockquote><p>The minimum indentation for script languages, such as Perl, Python, and
7225
6113
Bash. Default: <code>4</code>.
7226
</td></tr>
7227
</table>
6114
</p></blockquote></div>
7228
6115
7229
6116
<p>The maximum width of line numbers is controlled by this resource.
7230
6117
7231
<p>
7232
<table width="100%">
7233
<tr>
7234
<td align="left"><b>lineNumberWidth</b><i> </i>(<i>class LineNumberWidth</i>)<i>
7235
</i></td>
7236
<td align="right">Resource</td>
7237
</tr>
7238
</table>
7239
<table width="95%" align="center">
7240
<tr><td>
7241
The number of columns to use for line numbers (if displaying line
6118
<div class="defun">
6119
— Resource: <b>lineNumberWidth</b> (<var>class LineNumberWidth</var>)<var><a name="index-lineNumberWidth-653"></a></var><br>
6120
<blockquote><p>The number of columns to use for line numbers (if displaying line
7242
6121
numbers is enabled). Line numbers wider than this value extend into
7243
6122
the breakpoint space. Default: <code>4</code>.
7244
</td></tr>
7245
</table>
7246
7247
<p>If your source code uses a tab width different from <code>8</code> (the
7248
default), you can set an alternate width using the <code>Edit =>
7249
Preferences => Source => Tab width</code> slider.
7250
7251
<p>
7252
<table width="100%">
7253
<tr>
7254
<td align="left"><b>tabWidth</b><i> </i>(<i>class TabWidth</i>)<i>
7255
</i></td>
7256
<td align="right">Resource</td>
7257
</tr>
7258
</table>
7259
<table width="95%" align="center">
7260
<tr><td>
7261
The tab width used in the source window (default: <code>8</code>)
7262
</td></tr>
7263
</table>
6123
</p></blockquote></div>
6124
6125
<p><a name="index-Tab-width-654"></a><a name="index-Tab-Width-655"></a>
6126
If your source code uses a tab width different from <code>8</code> (the
6127
default), you can set an alternate width using the ‘<samp><span class="samp">Edit
6128
Preferences Source Tab width</span></samp>’ slider.
6129
6130
<div class="defun">
6131
— Resource: <b>tabWidth</b> (<var>class TabWidth</var>)<var><a name="index-tabWidth-656"></a></var><br>
6132
<blockquote><p>The tab width used in the source window (default: <code>8</code>)
6133
</p></blockquote></div>
7264
6134
7265
6135
<div class="node">
7266
6136
<p><hr>
7267
<small class=header>
7268
Node:<a name="Customizing%20Source%20Scrolling">Customizing Source Scrolling</a>,
7269
Next:<a rel="next" accesskey="n" href="#Customizing%20Source%20Lookup">Customizing Source Lookup</a>,
7270
Previous:<a rel="previous" accesskey="p" href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>,
7271
Up:<a rel="up" accesskey="u" href="#Customizing%20Source">Customizing Source</a>
6137
<a name="Customizing-Source-Scrolling"></a>
6138
Next: <a rel="next" accesskey="n" href="#Customizing-Source-Lookup">Customizing Source Lookup</a>,
6139
Previous: <a rel="previous" accesskey="p" href="#Customizing-Source-Appearance">Customizing Source Appearance</a>,
6140
Up: <a rel="up" accesskey="u" href="#Customizing-Source">Customizing Source</a>
7272
6141
</small>
7273
6142
7274
<br>
6143
7275
6144
</div>
7276
6145
7277
<h4 class="subsection">Customizing Source Scrolling</h4>
7278
7279
<p>These resources control when the source window is scrolled:
7280
7281
<p>
7282
<table width="100%">
7283
<tr>
7284
<td align="left"><b>linesAboveCursor</b><i> </i>(<i>class LinesAboveCursor</i>)<i>
7285
</i></td>
7286
<td align="right">Resource</td>
7287
</tr>
7288
</table>
7289
<table width="95%" align="center">
7290
<tr><td>
7291
The minimum number of lines to show before the current location.
6146
<h4 class="subsection">4.4.4 Customizing Source Scrolling</h4>
6147
6148
<p>These resources control when the source window is scrolled:
6149
6150
<div class="defun">
6151
— Resource: <b>linesAboveCursor</b> (<var>class LinesAboveCursor</var>)<var><a name="index-linesAboveCursor-657"></a></var><br>
6152
<blockquote><p>The minimum number of lines to show before the current location.
7292
6153
Default is <code>2</code>.
7293
</td></tr>
7294
</table>
6154
</p></blockquote></div>
7295
6155
7296
<p>
7297
<table width="100%">
7298
<tr>
7299
<td align="left"><b>linesBelowCursor</b><i> </i>(<i>class LinesBelowCursor</i>)<i>
7300
</i></td>
7301
<td align="right">Resource</td>
7302
</tr>
7303
</table>
7304
<table width="95%" align="center">
7305
<tr><td>
7306
The minimum number of lines to show after the current location.
6156
<div class="defun">
6157
— Resource: <b>linesBelowCursor</b> (<var>class LinesBelowCursor</var>)<var><a name="index-linesBelowCursor-658"></a></var><br>
6158
<blockquote><p>The minimum number of lines to show after the current location.
7307
6159
Default is <code>3</code>.
7308
</td></tr>
7309
</table>
6160
</p></blockquote></div>
7310
6161
7311
6162
<div class="node">
7312
6163
<p><hr>
7313
<small class=header>
7314
Node:<a name="Customizing%20Source%20Lookup">Customizing Source Lookup</a>,
7315
Next:<a rel="next" accesskey="n" href="#Customizing%20File%20Filtering">Customizing File Filtering</a>,
7316
Previous:<a rel="previous" accesskey="p" href="#Customizing%20Source%20Scrolling">Customizing Source Scrolling</a>,
7317
Up:<a rel="up" accesskey="u" href="#Customizing%20Source">Customizing Source</a>
6164
<a name="Customizing-Source-Lookup"></a>
6165
Next: <a rel="next" accesskey="n" href="#Customizing-File-Filtering">Customizing File Filtering</a>,
6166
Previous: <a rel="previous" accesskey="p" href="#Customizing-Source-Scrolling">Customizing Source Scrolling</a>,
6167
Up: <a rel="up" accesskey="u" href="#Customizing-Source">Customizing Source</a>
7318
6168
</small>
7319
6169
7320
<br>
6170
7321
6171
</div>
7322
6172
7323
<h4 class="subsection">Customizing Source Lookup</h4>
6173
<h4 class="subsection">4.4.5 Customizing Source Lookup</h4>
7324
6174
7325
<p>Some <small>DBX</small> and <small>XDB</small> variants do not properly handle paths in source file
6175
<p><a name="index-Refer-to-Program-Sources-659"></a>Some <acronym>DBX</acronym> and <acronym>XDB</acronym> variants do not properly handle paths in source file
7326
6176
specifications. If you want the inferior debugger to refer to source
7327
locations by source base names only, unset the <code>Edit =>
7328
Preferences => Source => Refer to Program Sources by full
7329
path name</code> option.
6177
locations by source base names only, unset the ‘<samp><span class="samp">Edit
6178
Preferences Source Refer to Program Sources by full
6179
path name</span></samp>’ option.
7330
6180
7331
6181
<p>This is related to the following resource:
7332
6182
7333
<p>
7334
<table width="100%">
7335
<tr>
7336
<td align="left"><b>useSourcePath</b><i> </i>(<i>class UseSourcePath</i>)<i>
7337
</i></td>
7338
<td align="right">Resource</td>
7339
</tr>
7340
</table>
7341
<table width="95%" align="center">
7342
<tr><td>
7343
If this is <code>off</code> (default), the inferior debugger refers to
6183
<div class="defun">
6184
— Resource: <b>useSourcePath</b> (<var>class UseSourcePath</var>)<var><a name="index-useSourcePath-660"></a></var><br>
6185
<blockquote><p>If this is ‘<samp><span class="samp">off</span></samp>’ (default), the inferior debugger refers to
7344
6186
source code locations only by their base names. If this is
7345
<code>on</code> (default), <small>DDD</small> uses the full source code paths.
7346
</td></tr>
7347
</table>
6187
‘<samp><span class="samp">on</span></samp>’ (default), <acronym>DDD</acronym> uses the full source code paths.
6188
</p></blockquote></div>
7348
6189
7349
<p>By default, <small>DDD</small> caches source files in memory. This is
6190
<p><a name="index-Cache-source-files-661"></a>By default, <acronym>DDD</acronym> caches source files in memory. This is
7350
6191
convenient for remote debugging, since remote file access may be slow.
7351
If you want to reduce memory usage, unset the <code>Edit =>
7352
Preferences => Source => Cache source files</code> option.
6192
If you want to reduce memory usage, unset the ‘<samp><span class="samp">Edit
6193
Preferences Source Cache source files</span></samp>’ option.
7353
6194
7354
6195
<p>This is related to the following resource:
7355
6196
7356
<p>
7357
<table width="100%">
7358
<tr>
7359
<td align="left"><b>cacheSourceFiles</b><i> </i>(<i>class CacheSourceFiles</i>)<i>
7360
</i></td>
7361
<td align="right">Resource</td>
7362
</tr>
7363
</table>
7364
<table width="95%" align="center">
7365
<tr><td>
7366
Whether to cache source files (<code>on</code>, default) or not
7367
(<code>off</code>). Caching source files requires more memory, but makes
7368
<small>DDD</small> run faster.
7369
</td></tr>
7370
</table>
6197
<div class="defun">
6198
— Resource: <b>cacheSourceFiles</b> (<var>class CacheSourceFiles</var>)<var><a name="index-cacheSourceFiles-662"></a></var><br>
6199
<blockquote><p>Whether to cache source files (‘<samp><span class="samp">on</span></samp>’, default) or not
6200
(‘<samp><span class="samp">off</span></samp>’). Caching source files requires more memory, but makes
6201
<acronym>DDD</acronym> run faster.
6202
</p></blockquote></div>
7371
6203
7372
6204
<div class="node">
7373
6205
<p><hr>
7374
<small class=header>
7375
Node:<a name="Customizing%20File%20Filtering">Customizing File Filtering</a>,
7376
Previous:<a rel="previous" accesskey="p" href="#Customizing%20Source%20Lookup">Customizing Source Lookup</a>,
7377
Up:<a rel="up" accesskey="u" href="#Customizing%20Source">Customizing Source</a>
6206
<a name="Customizing-File-Filtering"></a>
6207
Previous: <a rel="previous" accesskey="p" href="#Customizing-Source-Lookup">Customizing Source Lookup</a>,
6208
Up: <a rel="up" accesskey="u" href="#Customizing-Source">Customizing Source</a>
7378
6209
</small>
7379
6210
7380
<br>
6211
7381
6212
</div>
7382
6213
7383
<h4 class="subsection">Customizing File Filtering</h4>
7384
7385
<p>You can control whether <small>DDD</small> should filter files to be opened.
7386
7387
<p>
7388
<table width="100%">
7389
<tr>
7390
<td align="left"><b>filterFiles</b><i> </i>(<i>class FilterFiles</i>)<i>
7391
</i></td>
7392
<td align="right">Resource</td>
7393
</tr>
7394
</table>
7395
<table width="95%" align="center">
7396
<tr><td>
7397
If this is <code>on</code> (default), <small>DDD</small> filters files when opening
6214
<h4 class="subsection">4.4.6 Customizing File Filtering</h4>
6215
6216
<p>You can control whether <acronym>DDD</acronym> should filter files to be opened.
6217
6218
<div class="defun">
6219
— Resource: <b>filterFiles</b> (<var>class FilterFiles</var>)<var><a name="index-filterFiles-663"></a></var><br>
6220
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’ (default), <acronym>DDD</acronym> filters files when opening
7398
6221
execution files, core dumps, or source files, such that the selection
7399
shows only suitable files. This requires that <small>DDD</small> opens each
7400
file, which may take time. If this is <code>off</code>, <small>DDD</small> always
6222
shows only suitable files. This requires that <acronym>DDD</acronym> opens each
6223
file, which may take time. If this is ‘<samp><span class="samp">off</span></samp>’, <acronym>DDD</acronym> always
7401
6224
presents all available files.
7402
</td></tr>
7403
</table>
6225
</p></blockquote></div>
7404
6226
7405
6227
<div class="node">
7406
6228
<p><hr>
7407
<small class=header>
7408
Node:<a name="Stopping">Stopping</a>,
7409
Next:<a rel="next" accesskey="n" href="#Running">Running</a>,
7410
Previous:<a rel="previous" accesskey="p" href="#Navigating">Navigating</a>,
7411
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
6229
<a name="Stopping"></a>
6230
Next: <a rel="next" accesskey="n" href="#Running">Running</a>,
6231
Previous: <a rel="previous" accesskey="p" href="#Navigating">Navigating</a>,
6232
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
7412
6233
</small>
7413
6234
7414
<br>
6235
7415
6236
</div>
7416
6237
7417
<h2 class="chapter">Stopping the Program</h2>
6238
<h2 class="chapter">5 Stopping the Program</h2>
7418
6239
7419
<p>The principal purposes of using a debugger are so that you can stop your
6240
<p>The principal purposes of using a debugger are so that you can stop your
7420
6241
program before it terminates; or so that, if your program runs into
7421
6242
trouble, you can investigate and find out why.
7422
6243
7423
<p>Inside <small>DDD</small>, your program may stop for any of several reasons,
6244
<p>Inside <acronym>DDD</acronym>, your program may stop for any of several reasons,
7424
6245
such as a signal, a breakpoint, or reaching a new line after a
7425
<small>DDD</small> command such as <code>Step</code>. You may then examine and
6246
<acronym>DDD</acronym> command such as ‘<samp><span class="samp">Step</span></samp>’. You may then examine and
7426
6247
change variables, set new breakpoints or remove old ones, and then
7427
6248
continue execution.
7428
6249
7429
<p>The inferior debuggers supported by <small>DDD</small> support two mechanisms
6250
<p>The inferior debuggers supported by <acronym>DDD</acronym> support two mechanisms
7430
6251
for stopping a program upon specific events:
7431
6252
7432
6253
<ul>
7433
7434
<li>A <dfn>breakpoint</dfn> makes your program stop whenever a certain point in
6254
<li><a name="index-Breakpoint-664"></a>A <dfn>breakpoint</dfn> makes your program stop whenever a certain point in
7435
6255
the program is reached. For each breakpoint, you can add conditions to
7436
6256
control in finer detail whether your program stops. Typically,
7437
6257
breakpoints are set before running the program.
7438
6258
7439
<li>A <dfn>watchpoint</dfn> is a special breakpoint that stops your program when
6259
<li><a name="index-Watchpoint-665"></a>A <dfn>watchpoint</dfn> is a special breakpoint that stops your program when
7440
6260
the value of an expression changes.
7441
6261
</ul>
7442
6262
7444
6264
<li><a accesskey="1" href="#Breakpoints">Breakpoints</a>: Stop at a certain point.
7445
6265
<li><a accesskey="2" href="#Watchpoints">Watchpoints</a>: Stop at a certain condition.
7446
6266
<li><a accesskey="3" href="#Interrupting">Interrupting</a>: Stop manually.
7447
<li><a accesskey="4" href="#Stopping%20X%20Programs">Stopping X Programs</a>: Take care of grabbed pointers!
6267
<li><a accesskey="4" href="#Stopping-X-Programs">Stopping X Programs</a>: Take care of grabbed pointers!
7448
6268
</ul>
7449
6269
7450
6270
<div class="node">
7451
6271
<p><hr>
7452
<small class=header>
7453
Node:<a name="Breakpoints">Breakpoints</a>,
7454
Next:<a rel="next" accesskey="n" href="#Watchpoints">Watchpoints</a>,
7455
Up:<a rel="up" accesskey="u" href="#Stopping">Stopping</a>
6272
<a name="Breakpoints"></a>
6273
Next: <a rel="next" accesskey="n" href="#Watchpoints">Watchpoints</a>,
6274
Up: <a rel="up" accesskey="u" href="#Stopping">Stopping</a>
7456
6275
</small>
7457
6276
7458
<br>
6277
7459
6278
</div>
7460
6279
7461
<h3 class="section">Breakpoints</h3>
6280
<h3 class="section">5.1 Breakpoints</h3>
7462
6281
7463
6282
<ul class="menu">
7464
<li><a accesskey="1" href="#Setting%20Breakpoints">Setting Breakpoints</a>:
7465
<li><a accesskey="2" href="#Deleting%20Breakpoints">Deleting Breakpoints</a>:
7466
<li><a accesskey="3" href="#Disabling%20Breakpoints">Disabling Breakpoints</a>:
7467
<li><a accesskey="4" href="#Temporary%20Breakpoints">Temporary Breakpoints</a>:
7468
<li><a accesskey="5" href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>:
7469
<li><a accesskey="6" href="#Breakpoint%20Conditions">Breakpoint Conditions</a>:
7470
<li><a accesskey="7" href="#Breakpoint%20Ignore%20Counts">Breakpoint Ignore Counts</a>:
7471
<li><a accesskey="8" href="#Breakpoint%20Commands">Breakpoint Commands</a>:
7472
<li><a accesskey="9" href="#Moving%20and%20Copying%20Breakpoints">Moving and Copying Breakpoints</a>:
7473
<li><a href="#Looking%20up%20Breakpoints">Looking up Breakpoints</a>:
7474
<li><a href="#Editing%20all%20Breakpoints">Editing all Breakpoints</a>:
7475
<li><a href="#Hardware-Assisted%20Breakpoints">Hardware-Assisted Breakpoints</a>:
6283
<li><a accesskey="1" href="#Setting-Breakpoints">Setting Breakpoints</a>
6284
<li><a accesskey="2" href="#Deleting-Breakpoints">Deleting Breakpoints</a>
6285
<li><a accesskey="3" href="#Disabling-Breakpoints">Disabling Breakpoints</a>
6286
<li><a accesskey="4" href="#Temporary-Breakpoints">Temporary Breakpoints</a>
6287
<li><a accesskey="5" href="#Editing-Breakpoint-Properties">Editing Breakpoint Properties</a>
6288
<li><a accesskey="6" href="#Breakpoint-Conditions">Breakpoint Conditions</a>
6289
<li><a accesskey="7" href="#Breakpoint-Ignore-Counts">Breakpoint Ignore Counts</a>
6290
<li><a accesskey="8" href="#Breakpoint-Commands">Breakpoint Commands</a>
6291
<li><a accesskey="9" href="#Moving-and-Copying-Breakpoints">Moving and Copying Breakpoints</a>
6292
<li><a href="#Looking-up-Breakpoints">Looking up Breakpoints</a>
6293
<li><a href="#Editing-all-Breakpoints">Editing all Breakpoints</a>
6294
<li><a href="#Hardware_002dAssisted-Breakpoints">Hardware-Assisted Breakpoints</a>
7476
6295
</ul>
7477
6296
7478
6297
<div class="node">
7479
6298
<p><hr>
7480
<small class=header>
7481
Node:<a name="Setting%20Breakpoints">Setting Breakpoints</a>,
7482
Next:<a rel="next" accesskey="n" href="#Deleting%20Breakpoints">Deleting Breakpoints</a>,
7483
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6299
<a name="Setting-Breakpoints"></a>
6300
Next: <a rel="next" accesskey="n" href="#Deleting-Breakpoints">Deleting Breakpoints</a>,
6301
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7484
6302
</small>
7485
6303
7486
<br>
6304
7487
6305
</div>
7488
6306
7489
<h4 class="subsection">Setting Breakpoints</h4>
7490
7491
<p>You can set breakpoints by location or by name.
7492
7493
<h5 class="subsubsection">Setting Breakpoints by Location</h5>
7494
7495
<p>Breakpoints are set at a specific location in the program.
7496
7497
<p>If the source line is visible, click with <em>mouse button 1</em> on the
7498
left of the source line and then on the <code>Break</code> button.
6307
<h4 class="subsection">5.1.1 Setting Breakpoints</h4>
6308
6309
<p><a name="index-Breakpoint_002c-setting-666"></a>
6310
You can set breakpoints by location or by name.
6311
6312
<!-- @node Setting Breakpoints by Location -->
6313
<h5 class="subsubsection">5.1.1.1 Setting Breakpoints by Location</h5>
6314
6315
<p>Breakpoints are set at a specific location in the program.
6316
6317
<p><a name="index-Break-667"></a>If the source line is visible, click with <em>mouse button 1</em> on the
6318
left of the source line and then on the ‘<samp><span class="samp">Break</span></samp>’ button.
7499
6319
7500
6320
<p>As a faster alternative, you can simply press <em>mouse button 3</em> on
7501
the left of the source line and select the <code>Set Breakpoint</code> item
6321
the left of the source line and select the ‘<samp><span class="samp">Set Breakpoint</span></samp>’ item
7502
6322
from the line popup menu.
7503
6323
7504
<br><p>
6324
<pre class="sp">
6325
6326
</pre>
7505
6327
<div align="center"><img src="PICS/ddd-line-popup.jpg" alt="PICS/ddd-line-popup.jpg"></div>
7506
<br><p>
7507
<p>As an even faster alternative, you can simply double-click on the left
6328
<pre class="sp">
6329
6330
</pre>
6331
6332
As an even faster alternative, you can simply double-click on the left
7508
6333
of the source line to set a breakpoint.
7509
6334
7510
<p>As yet another alternative, you can select <code>Source =>
7511
Breakpoints</code>. Click on the <code>Break</code> button and enter the location.
6335
<p><a name="index-Break-668"></a>As yet another alternative, you can select ‘<samp><span class="samp">Source
6336
Breakpoints</span></samp>’. Click on the ‘<samp><span class="samp">Break</span></samp>’ button and enter the location.
7512
6337
7513
6338
<p>(If you find this number of alternatives confusing, be aware that
7514
<small>DDD</small> users fall into three categories, which must all be
7515
supported. <em>Novice users</em> explore <small>DDD</small> and may prefer to
6339
<acronym>DDD</acronym> users fall into three categories, which must all be
6340
supported. <em>Novice users</em> explore <acronym>DDD</acronym> and may prefer to
7516
6341
use one single mouse button. <em>Advanced users</em> know how to use
7517
6342
shortcuts and prefer popup menus. <em>Experienced users</em> prefer the
7518
6343
command line interface.)
7519
6344
7520
<p>Breakpoints are indicated by a plain stop sign, or as <code>#</code><var>n</var><code></code>,
6345
<p>Breakpoints are indicated by a plain stop sign, or as ‘<samp><span class="samp">#</span><var>n</var></samp>’,
7521
6346
where <var>n</var> is the breakpoint number. A greyed out stop sign (or
7522
<code>_</code><var>n</var><code>_</code>) indicates a disabled breakpoint. A stop sign with a
7523
question mark (or <code>?</code><var>n</var><code>?</code>) indicates a conditional breakpoint
6347
‘<samp><span class="samp">_</span><var>n</var><span class="samp">_</span></samp>’) indicates a disabled breakpoint. A stop sign with a
6348
question mark (or ‘<samp><span class="samp">?</span><var>n</var><span class="samp">?</span></samp>’) indicates a conditional breakpoint
7524
6349
or a breakpoint with an ignore count set.
7525
6350
7526
<p>If you set a breakpoint by mistake, use <code>Edit => Undo</code> to delete
6351
<p>If you set a breakpoint by mistake, use ‘<samp><span class="samp">Edit Undo</span></samp>’ to delete
7527
6352
it again.
7528
6353
7529
<h5 class="subsubsection">Setting Breakpoints by Name</h5>
6354
<!-- @node Setting Breakpoints by Name -->
6355
<h5 class="subsubsection">5.1.1.2 Setting Breakpoints by Name</h5>
7530
6356
7531
<p>If the function name is visible, click with <em>mouse button 1</em> on the
6357
<p>If the function name is visible, click with <em>mouse button 1</em> on the
7532
6358
function name. The function name is then copied to the argument field.
7533
Click on the <code>Break</code> button to set a breakpoint there.
6359
Click on the ‘<samp><span class="samp">Break</span></samp>’ button to set a breakpoint there.
7534
6360
7535
6361
<p>As a shorter alternative, you can simply press <em>mouse button 3</em> on
7536
the function name and select the <code>Break at</code> item from the popup
6362
the function name and select the ‘<samp><span class="samp">Break at</span></samp>’ item from the popup
7537
6363
menu.
7538
6364
7539
<p>As yet another alternative, you can click on <code>Break...</code> from
7540
the Breakpoint editor (invoked through <code>Source =>
7541
Breakpoints</code>) and enter the function name.
7542
7543
<h5 class="subsubsection">Setting Regexp Breakpoints</h5>
7544
7545
<p>Using <small>GDB</small>, you can also set a breakpoint on all functions that match a
7546
given string. <code>Break => Set Breakpoints at Regexp ()</code> sets
6365
<p>As yet another alternative, you can click on ‘<samp><span class="samp">Break...</span></samp>’ from
6366
the Breakpoint editor (invoked through ‘<samp><span class="samp">Source
6367
Breakpoints</span></samp>’) and enter the function name.
6368
6369
<!-- @node Setting Regexp Breakpoints -->
6370
<h5 class="subsubsection">5.1.1.3 Setting Regexp Breakpoints</h5>
6371
6372
<p>Using <acronym>GDB</acronym>, you can also set a breakpoint on all functions that match a
6373
given string. ‘<samp><span class="samp">Break Set Breakpoints at Regexp ()</span></samp>’ sets
7547
6374
a breakpoint on all functions whose name matches the <em>regular
7548
expression</em> given in <code>()</code>. Here are some examples:
6375
expression</em> given in ‘<samp><span class="samp">()</span></samp>’. Here are some examples:
7549
6376
7550
6377
<ul>
7551
<li>To set a breakpoint on every function that starts with <code>Xm</code>, set
7552
<code>()</code> to <code>^Xm</code>.
7553
<li>To set a breakpoint on every member of class <code>Date</code>, set
7554
<code>()</code> to <code>^Date::</code>.
6378
<li>To set a breakpoint on every function that starts with ‘<samp><span class="samp">Xm</span></samp>’, set
6379
‘<samp><span class="samp">()</span></samp>’ to ‘<samp><span class="samp">^Xm</span></samp>’.
6380
<li>To set a breakpoint on every member of class ‘<samp><span class="samp">Date</span></samp>’, set
6381
‘<samp><span class="samp">()</span></samp>’ to ‘<samp><span class="samp">^Date::</span></samp>’.
7555
6382
<li>To set a breakpoint on every function whose name contains
7556
<code>_fun</code>, set <code>()</code> to <code>_fun</code>.
7557
<li>To set a breakpoint on every function that ends in <code>_test</code>,
7558
set <code>()</code> to <code>_test$</code>.
6383
‘<samp><span class="samp">_fun</span></samp>’, set ‘<samp><span class="samp">()</span></samp>’ to ‘<samp><span class="samp">_fun</span></samp>’.
6384
<li>To set a breakpoint on every function that ends in ‘<samp><span class="samp">_test</span></samp>’,
6385
set ‘<samp><span class="samp">()</span></samp>’ to ‘<samp><span class="samp">_test$</span></samp>’.
7559
6386
</ul>
7560
6387
7561
6388
<div class="node">
7562
6389
<p><hr>
7563
<small class=header>
7564
Node:<a name="Deleting%20Breakpoints">Deleting Breakpoints</a>,
7565
Next:<a rel="next" accesskey="n" href="#Disabling%20Breakpoints">Disabling Breakpoints</a>,
7566
Previous:<a rel="previous" accesskey="p" href="#Setting%20Breakpoints">Setting Breakpoints</a>,
7567
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6390
<a name="Deleting-Breakpoints"></a>
6391
Next: <a rel="next" accesskey="n" href="#Disabling-Breakpoints">Disabling Breakpoints</a>,
6392
Previous: <a rel="previous" accesskey="p" href="#Setting-Breakpoints">Setting Breakpoints</a>,
6393
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7568
6394
</small>
7569
6395
7570
<br>
6396
7571
6397
</div>
7572
6398
7573
<h4 class="subsection">Deleting Breakpoints</h4>
6399
<h4 class="subsection">5.1.2 Deleting Breakpoints</h4>
7574
6400
7575
<p>To delete a visible breakpoint, click with <em>mouse button 1</em> on the
6401
<p><a name="index-Breakpoint_002c-deleting-669"></a>
6402
<a name="index-Clear-670"></a>To delete a visible breakpoint, click with <em>mouse button 1</em> on the
7576
6403
breakpoint. The breakpoint location is copied to the argument field.
7577
Click on the <code>Clear</code> button to delete all breakpoints there.
6404
Click on the ‘<samp><span class="samp">Clear</span></samp>’ button to delete all breakpoints there.
7578
6405
7579
6406
<p>If the function name is visible, click with <em>mouse button 1</em> on the
7580
6407
function name. The function name is copied to the argument field.
7581
Click on the <code>Clear</code> button to clear all breakpoints there.
6408
Click on the ‘<samp><span class="samp">Clear</span></samp>’ button to clear all breakpoints there.
7582
6409
7583
<p>As a faster alternative, you can simply press <em>mouse button 3</em> on
7584
the breakpoint and select the <code>Delete Breakpoint</code> item from the
6410
<p><a name="index-Delete-Breakpoint-671"></a>As a faster alternative, you can simply press <em>mouse button 3</em> on
6411
the breakpoint and select the ‘<samp><span class="samp">Delete Breakpoint</span></samp>’ item from the
7585
6412
popup menu.
7586
6413
7587
<p>As yet another alternative, you can select the breakpoint and click on
7588
<code>Delete</code> in the Breakpoint editor (invoked through <code>Source
7589
=> Breakpoints</code>).
6414
<p><a name="index-Delete-672"></a>As yet another alternative, you can select the breakpoint and click on
6415
‘<samp><span class="samp">Delete</span></samp>’ in the Breakpoint editor (invoked through ‘<samp><span class="samp">Source
6416
Breakpoints</span></samp>’).
7590
6417
7591
6418
<p>As an even faster alternative, you can simply double-click on the
7592
6419
breakpoint while holding <Ctrl>.
7593
6420
7594
6421
<div class="node">
7595
6422
<p><hr>
7596
<small class=header>
7597
Node:<a name="Disabling%20Breakpoints">Disabling Breakpoints</a>,
7598
Next:<a rel="next" accesskey="n" href="#Temporary%20Breakpoints">Temporary Breakpoints</a>,
7599
Previous:<a rel="previous" accesskey="p" href="#Deleting%20Breakpoints">Deleting Breakpoints</a>,
7600
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6423
<a name="Disabling-Breakpoints"></a>
6424
Next: <a rel="next" accesskey="n" href="#Temporary-Breakpoints">Temporary Breakpoints</a>,
6425
Previous: <a rel="previous" accesskey="p" href="#Deleting-Breakpoints">Deleting Breakpoints</a>,
6426
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7601
6427
</small>
7602
6428
7603
<br>
6429
7604
6430
</div>
7605
6431
7606
<h4 class="subsection">Disabling Breakpoints</h4>
6432
<h4 class="subsection">5.1.3 Disabling Breakpoints</h4>
7607
6433
7608
<p>Rather than deleting a breakpoint or watchpoint, you might prefer to
6434
<p><a name="index-Breakpoint_002c-disabling-673"></a><a name="index-Breakpoint_002c-enabling-674"></a>
6435
Rather than deleting a breakpoint or watchpoint, you might prefer to
7609
6436
<dfn>disable</dfn> it. This makes the breakpoint inoperative as if it had
7610
6437
been deleted, but remembers the information on the breakpoint so that
7611
you can <dfn>enable</dfn> it again later.<a rel="footnote" href="#fn-12"><sup>12</sup></a>
7612
7613
<p>To disable a breakpoint, press <em>mouse button 3</em> on the breakpoint
7614
symbol and select the <code>Disable Breakpoint</code> item from the breakpoint
7615
popup menu. To enable it again, select <code>Enable Breakpoint</code>.
7616
7617
<br><p>
6438
you can <dfn>enable</dfn> it again later.<a rel="footnote" href="#fn-12" name="fnd-12"><sup>12</sup></a>
6439
6440
<p><a name="index-Disable-Breakpoint-675"></a><a name="index-Enable-Breakpoint-676"></a>To disable a breakpoint, press <em>mouse button 3</em> on the breakpoint
6441
symbol and select the ‘<samp><span class="samp">Disable Breakpoint</span></samp>’ item from the breakpoint
6442
popup menu. To enable it again, select ‘<samp><span class="samp">Enable Breakpoint</span></samp>’.
6443
6444
<pre class="sp">
6445
6446
</pre>
7618
6447
<div align="center"><img src="PICS/ddd-bp-popup.jpg" alt="PICS/ddd-bp-popup.jpg"></div>
7619
<br><p>
7620
<p>As an alternative, you can select the breakpoint and click on
7621
<code>Disable</code> or <code>Enable</code> in the Breakpoint editor (invoked
7622
through <code>Source => Breakpoints</code>.
6448
<pre class="sp">
6449
6450
</pre>
6451
6452
<a name="index-Disable-677"></a><a name="index-Enable-678"></a>As an alternative, you can select the breakpoint and click on
6453
‘<samp><span class="samp">Disable</span></samp>’ or ‘<samp><span class="samp">Enable</span></samp>’ in the Breakpoint editor (invoked
6454
through ‘<samp><span class="samp">Source Breakpoints</span></samp>’.
7623
6455
7624
6456
<p>Disabled breakpoints are indicated by a grey stop sign, or
7625
<code>_</code><var>n</var><code>_</code>, where <var>n</var> is the breakpoint number.
6457
‘<samp><span class="samp">_</span><var>n</var><span class="samp">_</span></samp>’, where <var>n</var> is the breakpoint number.
7626
6458
7627
<p>The <code>Disable Breakpoint</code> item is also accessible via the
7628
<code>Clear</code> button. Just press and hold <em>mouse button 1</em> on the
6459
<p><a name="index-Clear-679"></a>The ‘<samp><span class="samp">Disable Breakpoint</span></samp>’ item is also accessible via the
6460
‘<samp><span class="samp">Clear</span></samp>’ button. Just press and hold <em>mouse button 1</em> on the
7629
6461
button to get a popup menu.
7630
6462
7631
6463
<div class="node">
7632
6464
<p><hr>
7633
<small class=header>
7634
Node:<a name="Temporary%20Breakpoints">Temporary Breakpoints</a>,
7635
Next:<a rel="next" accesskey="n" href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>,
7636
Previous:<a rel="previous" accesskey="p" href="#Disabling%20Breakpoints">Disabling Breakpoints</a>,
7637
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6465
<a name="Temporary-Breakpoints"></a>
6466
Next: <a rel="next" accesskey="n" href="#Editing-Breakpoint-Properties">Editing Breakpoint Properties</a>,
6467
Previous: <a rel="previous" accesskey="p" href="#Disabling-Breakpoints">Disabling Breakpoints</a>,
6468
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7638
6469
</small>
7639
6470
7640
<br>
6471
7641
6472
</div>
7642
6473
7643
<h4 class="subsection">Temporary Breakpoints</h4>
7644
7645
<p>A <dfn>temporary breakpoint</dfn> is immediately deleted as soon as it is
7646
reached.<a rel="footnote" href="#fn-13"><sup>13</sup></a>
7647
7648
<p>To set a temporary breakpoint, press <em>mouse button 3</em> on the left
7649
of the source line and select the <code>Set Temporary Breakpoint</code> item
6474
<h4 class="subsection">5.1.4 Temporary Breakpoints</h4>
6475
6476
<p><a name="index-Breakpoint_002c-temporary-680"></a>
6477
A <dfn>temporary breakpoint</dfn> is immediately deleted as soon as it is
6478
reached.<a rel="footnote" href="#fn-13" name="fnd-13"><sup>13</sup></a>
6479
6480
<p><a name="index-Set-Temporary-Breakpoint-681"></a>To set a temporary breakpoint, press <em>mouse button 3</em> on the left
6481
of the source line and select the ‘<samp><span class="samp">Set Temporary Breakpoint</span></samp>’ item
7650
6482
from the popup menu.
7651
6483
7652
6484
<p>As a faster alternative, you can simply double-click on the left of the
7656
6488
a specific location: just set the temporary breakpoint at this location
7657
6489
and continue execution.
7658
6490
7659
<p>The <code>Continue Until Here</code> item from the popup menu sets a temporary
6491
<p><a name="index-Continue-Until-Here-682"></a>The ‘<samp><span class="samp">Continue Until Here</span></samp>’ item from the popup menu sets a temporary
7660
6492
breakpoint on the left of the source line and immediately continues
7661
6493
execution. Execution stops when the temporary breakpoint is reached.
7662
6494
7663
<p>The <code>Set Temporary Breakpoint</code> and <code>Continue Until Here</code> items
7664
are also accessible via the <code>Break</code> button. Just press and hold
6495
<p>The ‘<samp><span class="samp">Set Temporary Breakpoint</span></samp>’ and ‘<samp><span class="samp">Continue Until Here</span></samp>’ items
6496
are also accessible via the ‘<samp><span class="samp">Break</span></samp>’ button. Just press and hold
7665
6497
<em>mouse button 1</em> on the button to get a popup menu.
7666
6498
7667
6499
<div class="node">
7668
6500
<p><hr>
7669
<small class=header>
7670
Node:<a name="Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>,
7671
Next:<a rel="next" accesskey="n" href="#Breakpoint%20Conditions">Breakpoint Conditions</a>,
7672
Previous:<a rel="previous" accesskey="p" href="#Temporary%20Breakpoints">Temporary Breakpoints</a>,
7673
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6501
<a name="Editing-Breakpoint-Properties"></a>
6502
Next: <a rel="next" accesskey="n" href="#Breakpoint-Conditions">Breakpoint Conditions</a>,
6503
Previous: <a rel="previous" accesskey="p" href="#Temporary-Breakpoints">Temporary Breakpoints</a>,
6504
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7674
6505
</small>
7675
6506
7676
<br>
6507
7677
6508
</div>
7678
6509
7679
<h4 class="subsection">Editing Breakpoint Properties</h4>
6510
<h4 class="subsection">5.1.5 Editing Breakpoint Properties</h4>
7680
6511
7681
<p>You can change all properties of a breakpoint by pressing <em>mouse
7682
button 3</em> on the breakpoint symbol and select <code>Properties</code>
6512
<p><a name="index-Breakpoint-properties-683"></a><a name="index-Breakpoint_002c-editing-684"></a>
6513
You can change all properties of a breakpoint by pressing <em>mouse
6514
button 3</em> on the breakpoint symbol and select ‘<samp><span class="samp">Properties</span></samp>’
7683
6515
from the breakpoint popup menu. This will pop up a dialog showing the
7684
6516
current properties of the selected breakpoint.
7685
6517
7686
<br><p>
6518
<pre class="sp">
6519
6520
</pre>
7687
6521
<div align="center"><img src="PICS/ddd-bp-properties.jpg" alt="PICS/ddd-bp-properties.jpg"></div>
7688
<br><p>
7689
<p>As an even faster alternative, you can simply double-click on the
6522
<pre class="sp">
6523
6524
</pre>
6525
6526
As an even faster alternative, you can simply double-click on the
7690
6527
breakpoint.
7691
6528
7692
6529
<ul>
7693
<li>Click on <code>Lookup</code> to move the cursor to the breakpoint's
6530
<li>Click on ‘<samp><span class="samp">Lookup</span></samp>’ to move the cursor to the breakpoint's
7694
6531
location.
7695
<li>Click on <code>Enable</code> to enable the breakpoint.
7696
<li>Click on <code>Disable</code> to disable the breakpoint.
7697
<li>Click on <code>Temp</code> to make the breakpoint temporary.<a rel="footnote" href="#fn-14"><sup>14</sup></a>
7698
<li>Click on <code>Delete</code> to delete the breakpoint.
7699
</ul>
6532
<a name="index-Lookup-685"></a><li>Click on ‘<samp><span class="samp">Enable</span></samp>’ to enable the breakpoint.
6533
<a name="index-Enable-686"></a><li>Click on ‘<samp><span class="samp">Disable</span></samp>’ to disable the breakpoint.
6534
<a name="index-Disable-687"></a><li>Click on ‘<samp><span class="samp">Temp</span></samp>’ to make the breakpoint temporary.<a rel="footnote" href="#fn-14" name="fnd-14"><sup>14</sup></a>
6535
<a name="index-Temp-688"></a><li>Click on ‘<samp><span class="samp">Delete</span></samp>’ to delete the breakpoint.
6536
<a name="index-Delete-689"></a></ul>
7700
6537
7701
6538
<div class="node">
7702
6539
<p><hr>
7703
<small class=header>
7704
Node:<a name="Breakpoint%20Conditions">Breakpoint Conditions</a>,
7705
Next:<a rel="next" accesskey="n" href="#Breakpoint%20Ignore%20Counts">Breakpoint Ignore Counts</a>,
7706
Previous:<a rel="previous" accesskey="p" href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>,
7707
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6540
<a name="Breakpoint-Conditions"></a>
6541
Next: <a rel="next" accesskey="n" href="#Breakpoint-Ignore-Counts">Breakpoint Ignore Counts</a>,
6542
Previous: <a rel="previous" accesskey="p" href="#Editing-Breakpoint-Properties">Editing Breakpoint Properties</a>,
6543
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7708
6544
</small>
7709
6545
7710
<br>
6546
7711
6547
</div>
7712
6548
7713
<h4 class="subsection">Breakpoint Conditions</h4>
6549
<h4 class="subsection">5.1.6 Breakpoint Conditions</h4>
7714
6550
7715
<p>The simplest sort of breakpoint breaks every time your program reaches a
6551
<p><a name="index-Conditions-on-breakpoints-690"></a><a name="index-Breakpoint-conditions-691"></a>
6552
The simplest sort of breakpoint breaks every time your program reaches a
7716
6553
specified place. You can also specify a <dfn>condition</dfn> for a
7717
6554
breakpoint. A condition is just a Boolean expression in your
7718
6555
programming language. A breakpoint with a condition evaluates the
7719
6556
expression each time your program reaches it, and your program stops
7720
6557
only if the condition is <em>true</em>.
7721
6558
7722
<p>This is the converse of using assertions for program validation; in that
7723
situation, you want to stop when the assertion is violated-that is,
6559
<p><a name="index-Assertions-and-breakpoints-692"></a>This is the converse of using assertions for program validation; in that
6560
situation, you want to stop when the assertion is violated–that is,
7724
6561
when the condition is false. In C, if you want to test an assertion
7725
6562
expressed by the condition <var>assertion</var>, you should set the condition
7726
<code>!</code><var>assertion</var><code></code> on the appropriate breakpoint.
6563
‘<samp><span class="samp">!</span><var>assertion</var></samp>’ on the appropriate breakpoint.
7727
6564
7728
6565
<p>Break conditions can have side effects, and may even call functions in
7729
6566
your program. This can be useful, for example, to activate functions
7730
6567
that log program progress, or to use your own print functions to format
7731
6568
special data structures. The effects are completely predictable unless
7732
6569
there is another enabled breakpoint at the same address. (In that case,
7733
<small>DDD</small> might see the other breakpoint first and stop your program
6570
<acronym>DDD</acronym> might see the other breakpoint first and stop your program
7734
6571
without checking the condition of this one.)
7735
6572
7736
<p>Note that breakpoint commands are usually more convenient and flexible
6573
<p><a name="index-Breakpoint-commands_002c-vs_002e-conditions-693"></a>Note that breakpoint commands are usually more convenient and flexible
7737
6574
for the purpose of performing side effects when a breakpoint is reached.
7738
See <a href="#Breakpoint%20Commands">Breakpoint Commands</a>, for details.
6575
See <a href="#Breakpoint-Commands">Breakpoint Commands</a>, for details.
7739
6576
7740
6577
<div class="node">
7741
6578
<p><hr>
7742
<small class=header>
7743
Node:<a name="Breakpoint%20Ignore%20Counts">Breakpoint Ignore Counts</a>,
7744
Next:<a rel="next" accesskey="n" href="#Breakpoint%20Commands">Breakpoint Commands</a>,
7745
Previous:<a rel="previous" accesskey="p" href="#Breakpoint%20Conditions">Breakpoint Conditions</a>,
7746
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6579
<a name="Breakpoint-Ignore-Counts"></a>
6580
Next: <a rel="next" accesskey="n" href="#Breakpoint-Commands">Breakpoint Commands</a>,
6581
Previous: <a rel="previous" accesskey="p" href="#Breakpoint-Conditions">Breakpoint Conditions</a>,
6582
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7747
6583
</small>
7748
6584
7749
<br>
6585
7750
6586
</div>
7751
6587
7752
<h4 class="subsection">Breakpoint Ignore Counts</h4>
6588
<h4 class="subsection">5.1.7 Breakpoint Ignore Counts</h4>
7753
6589
7754
<p>A special case of a breakpoint condition is to stop only when the
6590
<p><a name="index-Breakpoint-ignore-counts-694"></a><a name="index-Ignore-count-695"></a>
6591
A special case of a breakpoint condition is to stop only when the
7755
6592
breakpoint has been reached a certain number of times. This is so
7756
6593
useful that there is a special way to do it, using the <dfn>ignore
7757
6594
count</dfn> of the breakpoint. Every breakpoint has an ignore count, which
7762
6599
value is <var>n</var>, the breakpoint does not stop the next <var>n</var> times
7763
6600
your program reaches it.
7764
6601
7765
<p>In the field <code>Ignore Count</code> of the <code>Breakpoint Properties</code>
7766
panel, you can specify the breakpoint ignore count.<a rel="footnote" href="#fn-15"><sup>15</sup></a>
6602
<p><a name="index-Ignore-Count-696"></a>In the field ‘<samp><span class="samp">Ignore Count</span></samp>’ of the ‘<samp><span class="samp">Breakpoint Properties</span></samp>’
6603
panel, you can specify the breakpoint ignore count.<a rel="footnote" href="#fn-15" name="fnd-15"><sup>15</sup></a>
7767
6604
7768
6605
<p>If a breakpoint has a positive ignore count and a condition, the
7769
6606
condition is not checked. Once the ignore count reaches zero,
7770
<small>DDD</small> resumes checking the condition.
6607
<acronym>DDD</acronym> resumes checking the condition.
7771
6608
7772
6609
<div class="node">
7773
6610
<p><hr>
7774
<small class=header>
7775
Node:<a name="Breakpoint%20Commands">Breakpoint Commands</a>,
7776
Next:<a rel="next" accesskey="n" href="#Moving%20and%20Copying%20Breakpoints">Moving and Copying Breakpoints</a>,
7777
Previous:<a rel="previous" accesskey="p" href="#Breakpoint%20Ignore%20Counts">Breakpoint Ignore Counts</a>,
7778
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6611
<a name="Breakpoint-Commands"></a>
6612
Next: <a rel="next" accesskey="n" href="#Moving-and-Copying-Breakpoints">Moving and Copying Breakpoints</a>,
6613
Previous: <a rel="previous" accesskey="p" href="#Breakpoint-Ignore-Counts">Breakpoint Ignore Counts</a>,
6614
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7779
6615
</small>
7780
6616
7781
<br>
6617
7782
6618
</div>
7783
6619
7784
<h4 class="subsection">Breakpoint Commands</h4>
6620
<h4 class="subsection">5.1.8 Breakpoint Commands</h4>
7785
6621
7786
<p>You can give any breakpoint (or watchpoint) a series of <small>DDD</small>
6622
<p><a name="index-Breakpoint-commands-697"></a><a name="index-Command_002c-breakpoint-698"></a>
6623
You can give any breakpoint (or watchpoint) a series of <acronym>DDD</acronym>
7787
6624
commands to execute when your program stops due to that breakpoint. For
7788
6625
example, you might want to print the values of certain expressions, or
7789
enable other breakpoints.<a rel="footnote" href="#fn-16"><sup>16</sup></a>
6626
enable other breakpoints.<a rel="footnote" href="#fn-16" name="fnd-16"><sup>16</sup></a>
7790
6627
7791
<p>Using the <code>Commands</code> buttons of the <code>Breakpoint Properties</code>
6628
<p>Using the ‘<samp><span class="samp">Commands</span></samp>’ buttons of the ‘<samp><span class="samp">Breakpoint Properties</span></samp>’
7792
6629
panel, you can edit commands to be executed when the breakpoint is hit.
7793
6630
7794
<p>To edit breakpoint commands, click on <code>Edit >></code> and enter the
6631
<p>To edit breakpoint commands, click on ‘<samp><span class="samp">Edit >></span></samp>’ and enter the
7795
6632
commands in the commands editor. When done with editing, click on
7796
<code>Edit <<</code> to close the commands editor.
6633
‘<samp><span class="samp">Edit <<</span></samp>’ to close the commands editor.
7797
6634
7798
<p>Using <small>GDB</small>, you can also <dfn>record</dfn> a command sequence to be executed.
6635
<p>Using <acronym>GDB</acronym>, you can also <dfn>record</dfn> a command sequence to be executed.
7799
6636
To record a command sequence, follow these steps:
7800
6637
7801
6638
<ol type=1 start=1>
7802
<li>Click on <code>Record</code> to begin the recording of the breakpoint
6639
<li>Click on ‘<samp><span class="samp">Record</span></samp>’ to begin the recording of the breakpoint
7803
6640
commands.
7804
<li>Now interact with <small>DDD</small>. While recording, <small>DDD</small> does not
6641
<a name="index-Record-699"></a><li>Now interact with <acronym>DDD</acronym>. While recording, <acronym>DDD</acronym> does not
7805
6642
execute commands, but simply records them to be executed when the
7806
6643
breakpoint is hit. The recorded debugger commands are shown in the
7807
6644
debugger console.
7808
<li>To stop the recording, click on <code>End</code> or enter <code>end</code> at the
7809
<small>GDB</small> prompt. To <dfn>cancel</dfn> the recording, click on <code>Interrupt</code>
6645
<li>To stop the recording, click on ‘<samp><span class="samp">End</span></samp>’ or enter ‘<samp><span class="samp">end</span></samp>’ at the
6646
<acronym>GDB</acronym> prompt. To <dfn>cancel</dfn> the recording, click on ‘<samp><span class="samp">Interrupt</span></samp>’
7810
6647
or press <ESC>.
7811
<li>You can edit the breakpoint commands just recorded using <code>Edit >></code>.
6648
<a name="index-End-700"></a><li>You can edit the breakpoint commands just recorded using ‘<samp><span class="samp">Edit >></span></samp>’.
6649
<a name="index-Edit-_003e_003e-701"></a>
7812
6650
</ol>
7813
6651
7814
6652
<div class="node">
7815
6653
<p><hr>
7816
<small class=header>
7817
Node:<a name="Moving%20and%20Copying%20Breakpoints">Moving and Copying Breakpoints</a>,
7818
Next:<a rel="next" accesskey="n" href="#Looking%20up%20Breakpoints">Looking up Breakpoints</a>,
7819
Previous:<a rel="previous" accesskey="p" href="#Breakpoint%20Commands">Breakpoint Commands</a>,
7820
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6654
<a name="Moving-and-Copying-Breakpoints"></a>
6655
Next: <a rel="next" accesskey="n" href="#Looking-up-Breakpoints">Looking up Breakpoints</a>,
6656
Previous: <a rel="previous" accesskey="p" href="#Breakpoint-Commands">Breakpoint Commands</a>,
6657
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7821
6658
</small>
7822
6659
7823
<br>
6660
7824
6661
</div>
7825
6662
7826
<h4 class="subsection">Moving and Copying Breakpoints</h4>
6663
<h4 class="subsection">5.1.9 Moving and Copying Breakpoints</h4>
7827
6664
7828
<p>To move a breakpoint to a different location, press <em>mouse button
7829
1</em> on the stop sign and drag it to the desired location.<a rel="footnote" href="#fn-17"><sup>17</sup></a> This is equivalent to
6665
<p><a name="index-Breakpoint_002c-moving-702"></a><a name="index-Breakpoint_002c-copying-703"></a><a name="index-Breakpoint_002c-dragging-704"></a>
6666
To move a breakpoint to a different location, press <em>mouse button
6667
1</em> on the stop sign and drag it to the desired location.<a rel="footnote" href="#fn-17" name="fnd-17"><sup>17</sup></a> This is equivalent to
7830
6668
deleting the breakpoint at the old location and setting a breakpoint at
7831
6669
the new location. The new breakpoint inherits all properties of the old
7832
6670
breakpoint, except the breakpoint number.
7836
6674
7837
6675
<div class="node">
7838
6676
<p><hr>
7839
<small class=header>
7840
Node:<a name="Looking%20up%20Breakpoints">Looking up Breakpoints</a>,
7841
Next:<a rel="next" accesskey="n" href="#Editing%20all%20Breakpoints">Editing all Breakpoints</a>,
7842
Previous:<a rel="previous" accesskey="p" href="#Moving%20and%20Copying%20Breakpoints">Moving and Copying Breakpoints</a>,
7843
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6677
<a name="Looking-up-Breakpoints"></a>
6678
Next: <a rel="next" accesskey="n" href="#Editing-all-Breakpoints">Editing all Breakpoints</a>,
6679
Previous: <a rel="previous" accesskey="p" href="#Moving-and-Copying-Breakpoints">Moving and Copying Breakpoints</a>,
6680
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7844
6681
</small>
7845
6682
7846
<br>
6683
7847
6684
</div>
7848
6685
7849
<h4 class="subsection">Looking up Breakpoints</h4>
6686
<h4 class="subsection">5.1.10 Looking up Breakpoints</h4>
7850
6687
7851
<p>If you wish to lookup a specific breakpoint, select <code>Source
7852
=> Breakpoints => Lookup</code>. After selecting a breakpoint
7853
from the list and clicking the <code>Lookup</code> button, the breakpoint
6688
<p><a name="index-Breakpoint_002c-looking-up-705"></a><a name="index-Looking-up-breakpoints-706"></a>
6689
If you wish to lookup a specific breakpoint, select ‘<samp><span class="samp">Source
6690
Breakpoints Lookup</span></samp>’. After selecting a breakpoint
6691
from the list and clicking the ‘<samp><span class="samp">Lookup</span></samp>’ button, the breakpoint
7854
6692
location is displayed.
7855
6693
7856
<p>As an alternative, you can enter <code>#</code><var>n</var><code></code> in the argument field,
7857
where <var>n</var> is the breakpoint number, and click on the <code>Lookup</code>
6694
<p>As an alternative, you can enter ‘<samp><span class="samp">#</span><var>n</var></samp>’ in the argument field,
6695
where <var>n</var> is the breakpoint number, and click on the ‘<samp><span class="samp">Lookup</span></samp>’
7858
6696
button to find its definition.
7859
6697
7860
6698
<div class="node">
7861
6699
<p><hr>
7862
<small class=header>
7863
Node:<a name="Editing%20all%20Breakpoints">Editing all Breakpoints</a>,
7864
Next:<a rel="next" accesskey="n" href="#Hardware-Assisted%20Breakpoints">Hardware-Assisted Breakpoints</a>,
7865
Previous:<a rel="previous" accesskey="p" href="#Looking%20up%20Breakpoints">Looking up Breakpoints</a>,
7866
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6700
<a name="Editing-all-Breakpoints"></a>
6701
Next: <a rel="next" accesskey="n" href="#Hardware_002dAssisted-Breakpoints">Hardware-Assisted Breakpoints</a>,
6702
Previous: <a rel="previous" accesskey="p" href="#Looking-up-Breakpoints">Looking up Breakpoints</a>,
6703
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7867
6704
</small>
7868
6705
7869
<br>
6706
7870
6707
</div>
7871
6708
7872
<h4 class="subsection">Editing all Breakpoints</h4>
6709
<h4 class="subsection">5.1.11 Editing all Breakpoints</h4>
7873
6710
7874
<p>To view and edit all breakpoints at once, select <code>Source =>
7875
Breakpoints</code>. This will popup the <dfn>Breakpoint Editor</dfn> which
6711
<p><a name="index-Breakpoints_002c-editing-707"></a>
6712
To view and edit all breakpoints at once, select ‘<samp><span class="samp">Source
6713
Breakpoints</span></samp>’. This will popup the <dfn>Breakpoint Editor</dfn> which
7876
6714
displays the state of all breakpoints.
7877
6715
7878
<br><p>
6716
<pre class="sp">
6717
6718
</pre>
7879
6719
<div align="center"><img src="PICS/ddd-edit-breakpoints.jpg" alt="PICS/ddd-edit-breakpoints.jpg"></div>
7880
<br><p>
7881
<p>In the breakpoint editor, you can select individual breakpoints by
6720
<pre class="sp">
6721
6722
</pre>
6723
6724
In the breakpoint editor, you can select individual breakpoints by
7882
6725
clicking on them. Pressing <Ctrl> while clicking toggles the
7883
6726
selection. To edit the properties of all selected breakpoints, click on
7884
<code>Props</code>.
6727
‘<samp><span class="samp">Props</span></samp>’.
7885
6728
7886
6729
<div class="node">
7887
6730
<p><hr>
7888
<small class=header>
7889
Node:<a name="Hardware-Assisted%20Breakpoints">Hardware-Assisted Breakpoints</a>,
7890
Previous:<a rel="previous" accesskey="p" href="#Editing%20all%20Breakpoints">Editing all Breakpoints</a>,
7891
Up:<a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
6731
<a name="Hardware-Assisted-Breakpoints"></a>
6732
<a name="Hardware_002dAssisted-Breakpoints"></a>
6733
Previous: <a rel="previous" accesskey="p" href="#Editing-all-Breakpoints">Editing all Breakpoints</a>,
6734
Up: <a rel="up" accesskey="u" href="#Breakpoints">Breakpoints</a>
7892
6735
</small>
7893
6736
7894
<br>
6737
7895
6738
</div>
7896
6739
7897
<h4 class="subsection">Hardware-Assisted Breakpoints</h4>
6740
<h4 class="subsection">5.1.12 Hardware-Assisted Breakpoints</h4>
7898
6741
7899
<p>Using <small>GDB</small>, a few more commands related to breakpoints can be invoked
6742
<p><a name="index-Breakpoint_002c-hardware_002dassisted-708"></a>
6743
Using <acronym>GDB</acronym>, a few more commands related to breakpoints can be invoked
7900
6744
through the debugger console:
7901
6745
7902
6746
<dl>
7903
<dt><code>hbreak </code><var>position</var><code></code>
7904
<dd>Sets a hardware-assisted breakpoint at <var>position</var>. This command
6747
<dt><samp><span class="command">hbreak </span><var>position</var></samp><dd><a name="index-hbreak-709"></a><a name="index-g_t_0040acronym_007bEPROM_007d-code-debugging-710"></a><a name="index-g_t_0040acronym_007bROM_007d-code-debugging-711"></a>Sets a hardware-assisted breakpoint at <var>position</var>. This command
7905
6748
requires hardware support and some target hardware may not have this
7906
support. The main purpose of this is <small>EPROM</small>/<small>ROM</small> code
6749
support. The main purpose of this is <acronym>EPROM</acronym>/<acronym>ROM</acronym> code
7907
6750
debugging, so you can set a breakpoint at an instruction without
7908
6751
changing the instruction.
7909
6752
7910
<br><dt><code>thbreak </code><var>pos</var><code></code>
7911
<dd>Set a temporary hardware-assisted breakpoint at <var>pos</var>.
6753
<br><dt><samp><span class="command">thbreak </span><var>pos</var></samp><dd><a name="index-thbreak-712"></a>Set a temporary hardware-assisted breakpoint at <var>pos</var>.
7912
6754
</dl>
7913
6755
7914
<p>See <a href="gdb.html#Setting%20breakpoints">Setting breakpoints</a>, for details.
6756
<p>See <a href="gdb.html#Setting-breakpoints">Setting breakpoints</a>, for details.
7915
6757
7916
6758
<div class="node">
7917
6759
<p><hr>
7918
<small class=header>
7919
Node:<a name="Watchpoints">Watchpoints</a>,
7920
Next:<a rel="next" accesskey="n" href="#Interrupting">Interrupting</a>,
7921
Previous:<a rel="previous" accesskey="p" href="#Breakpoints">Breakpoints</a>,
7922
Up:<a rel="up" accesskey="u" href="#Stopping">Stopping</a>
6760
<a name="Watchpoints"></a>
6761
Next: <a rel="next" accesskey="n" href="#Interrupting">Interrupting</a>,
6762
Previous: <a rel="previous" accesskey="p" href="#Breakpoints">Breakpoints</a>,
6763
Up: <a rel="up" accesskey="u" href="#Stopping">Stopping</a>
7923
6764
</small>
7924
6765
7925
<br>
6766
7926
6767
</div>
7927
6768
7928
<h3 class="section">Watchpoints</h3>
6769
<h3 class="section">5.2 Watchpoints</h3>
7929
6770
7930
<p>You can make the program stop as soon as some variable value changes, or
6771
<p><a name="index-Watchpoint-713"></a>
6772
<a name="index-Assertions-and-watchpoints-714"></a>You can make the program stop as soon as some variable value changes, or
7931
6773
when some variable is read or written. This is called <dfn>setting a
7932
watchpoint on a variable</dfn>.<a rel="footnote" href="#fn-18"><sup>18</sup></a>
6774
watchpoint on a variable</dfn>.<a rel="footnote" href="#fn-18" name="fnd-18"><sup>18</sup></a>
7933
6775
7934
6776
<p>Watchpoints have much in common with breakpoints: in particular, you can
7935
6777
enable and disable them. You can also set conditions, ignore counts,
7944
6786
culprit.
7945
6787
7946
6788
<ul class="menu">
7947
<li><a accesskey="1" href="#Setting%20Watchpoints">Setting Watchpoints</a>:
7948
<li><a accesskey="2" href="#Editing%20Watchpoint%20Properties">Editing Watchpoint Properties</a>:
7949
<li><a accesskey="3" href="#Editing%20all%20Watchpoints">Editing all Watchpoints</a>:
7950
<li><a accesskey="4" href="#Deleting%20Watchpoints">Deleting Watchpoints</a>:
6789
<li><a accesskey="1" href="#Setting-Watchpoints">Setting Watchpoints</a>
6790
<li><a accesskey="2" href="#Editing-Watchpoint-Properties">Editing Watchpoint Properties</a>
6791
<li><a accesskey="3" href="#Editing-all-Watchpoints">Editing all Watchpoints</a>
6792
<li><a accesskey="4" href="#Deleting-Watchpoints">Deleting Watchpoints</a>
7951
6793
</ul>
7952
6794
7953
6795
<div class="node">
7954
6796
<p><hr>
7955
<small class=header>
7956
Node:<a name="Setting%20Watchpoints">Setting Watchpoints</a>,
7957
Next:<a rel="next" accesskey="n" href="#Editing%20Watchpoint%20Properties">Editing Watchpoint Properties</a>,
7958
Up:<a rel="up" accesskey="u" href="#Watchpoints">Watchpoints</a>
6797
<a name="Setting-Watchpoints"></a>
6798
Next: <a rel="next" accesskey="n" href="#Editing-Watchpoint-Properties">Editing Watchpoint Properties</a>,
6799
Up: <a rel="up" accesskey="u" href="#Watchpoints">Watchpoints</a>
7959
6800
</small>
7960
6801
7961
<br>
6802
7962
6803
</div>
7963
6804
7964
<h4 class="subsection">Setting Watchpoints</h4>
6805
<h4 class="subsection">5.2.1 Setting Watchpoints</h4>
7965
6806
7966
<p>If the variable name is visible, click with <em>mouse button 1</em> on the
6807
<p><a name="index-Watchpoint_002c-setting-715"></a>
6808
If the variable name is visible, click with <em>mouse button 1</em> on the
7967
6809
variable name. The variable name is copied to the argument field.
7968
6810
Otherwise, enter the variable name in the argument field. Click on the
7969
<code>Watch</code> button to set a watchpoint there.
6811
‘<samp><span class="samp">Watch</span></samp>’ button to set a watchpoint there.
7970
6812
7971
<p>Using <small>GDB</small> and <small>JDB</small> 1.2, you can set different types of watchpoints.
7972
Click and hold <em>mouse button 1</em> on the <code>Watch</code> button to get a
6813
<p><a name="index-Watch-716"></a>Using <acronym>GDB</acronym> and <acronym>JDB</acronym> 1.2, you can set different types of watchpoints.
6814
Click and hold <em>mouse button 1</em> on the ‘<samp><span class="samp">Watch</span></samp>’ button to get a
7973
6815
menu.
7974
6816
7975
6817
<div class="node">
7976
6818
<p><hr>
7977
<small class=header>
7978
Node:<a name="Editing%20Watchpoint%20Properties">Editing Watchpoint Properties</a>,
7979
Next:<a rel="next" accesskey="n" href="#Editing%20all%20Watchpoints">Editing all Watchpoints</a>,
7980
Previous:<a rel="previous" accesskey="p" href="#Setting%20Watchpoints">Setting Watchpoints</a>,
7981
Up:<a rel="up" accesskey="u" href="#Watchpoints">Watchpoints</a>
6819
<a name="Editing-Watchpoint-Properties"></a>
6820
Next: <a rel="next" accesskey="n" href="#Editing-all-Watchpoints">Editing all Watchpoints</a>,
6821
Previous: <a rel="previous" accesskey="p" href="#Setting-Watchpoints">Setting Watchpoints</a>,
6822
Up: <a rel="up" accesskey="u" href="#Watchpoints">Watchpoints</a>
7982
6823
</small>
7983
6824
7984
<br>
6825
7985
6826
</div>
7986
6827
7987
<h4 class="subsection">Editing Watchpoint Properties</h4>
6828
<h4 class="subsection">5.2.2 Editing Watchpoint Properties</h4>
7988
6829
7989
<p>To change the properties of a watchpoint, enter the name of the watched
6830
<p><a name="index-Watchpoint-properties-717"></a><a name="index-Watchpoint_002c-editing-718"></a>
6831
<a name="index-Watch-719"></a>To change the properties of a watchpoint, enter the name of the watched
7990
6832
variable in the argument field. Click and hold <em>mouse button 1</em> on
7991
the <code>Watch</code> button and select <code>Watchpoint Properties</code>.
6833
the ‘<samp><span class="samp">Watch</span></samp>’ button and select ‘<samp><span class="samp">Watchpoint Properties</span></samp>’.
7992
6834
7993
<p>The Watchpoint Properties panel has the same functionality as the
7994
Breakpoint Properties panel (see <a href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>). As
7995
an additional feature, you can click on <code>Print</code> to see the current
6835
<p><a name="index-Print-720"></a>The Watchpoint Properties panel has the same functionality as the
6836
Breakpoint Properties panel (see <a href="#Editing-Breakpoint-Properties">Editing Breakpoint Properties</a>). As
6837
an additional feature, you can click on ‘<samp><span class="samp">Print</span></samp>’ to see the current
7996
6838
value of a watched variable.
7997
6839
7998
6840
<div class="node">
7999
6841
<p><hr>
8000
<small class=header>
8001
Node:<a name="Editing%20all%20Watchpoints">Editing all Watchpoints</a>,
8002
Next:<a rel="next" accesskey="n" href="#Deleting%20Watchpoints">Deleting Watchpoints</a>,
8003
Previous:<a rel="previous" accesskey="p" href="#Editing%20Watchpoint%20Properties">Editing Watchpoint Properties</a>,
8004
Up:<a rel="up" accesskey="u" href="#Watchpoints">Watchpoints</a>
6842
<a name="Editing-all-Watchpoints"></a>
6843
Next: <a rel="next" accesskey="n" href="#Deleting-Watchpoints">Deleting Watchpoints</a>,
6844
Previous: <a rel="previous" accesskey="p" href="#Editing-Watchpoint-Properties">Editing Watchpoint Properties</a>,
6845
Up: <a rel="up" accesskey="u" href="#Watchpoints">Watchpoints</a>
8005
6846
</small>
8006
6847
8007
<br>
6848
8008
6849
</div>
8009
6850
8010
<h4 class="subsection">Editing all Watchpoints</h4>
6851
<h4 class="subsection">5.2.3 Editing all Watchpoints</h4>
8011
6852
8012
<p>To view and edit all watchpoints at once, select <code>Data =>
8013
Watchpoints</code>. This will popup the <dfn>Watchpoint Editor</dfn> which
6853
<p><a name="index-Watchpoints_002c-editing-721"></a>
6854
To view and edit all watchpoints at once, select ‘<samp><span class="samp">Data
6855
Watchpoints</span></samp>’. This will popup the <dfn>Watchpoint Editor</dfn> which
8014
6856
displays the state of all watchpoints.
8015
6857
8016
<p>The Watchpoint Editor has the same functionality as the Breakpoint
8017
Editor (see <a href="#Editing%20all%20Breakpoints">Editing all Breakpoints</a>). As an additional feature, you
8018
can click on <code>Print</code> to see the current value of a watched
6858
<p><a name="index-Print-722"></a>The Watchpoint Editor has the same functionality as the Breakpoint
6859
Editor (see <a href="#Editing-all-Breakpoints">Editing all Breakpoints</a>). As an additional feature, you
6860
can click on ‘<samp><span class="samp">Print</span></samp>’ to see the current value of a watched
8019
6861
variable.
8020
6862
8021
6863
<div class="node">
8022
6864
<p><hr>
8023
<small class=header>
8024
Node:<a name="Deleting%20Watchpoints">Deleting Watchpoints</a>,
8025
Previous:<a rel="previous" accesskey="p" href="#Editing%20all%20Watchpoints">Editing all Watchpoints</a>,
8026
Up:<a rel="up" accesskey="u" href="#Watchpoints">Watchpoints</a>
6865
<a name="Deleting-Watchpoints"></a>
6866
Previous: <a rel="previous" accesskey="p" href="#Editing-all-Watchpoints">Editing all Watchpoints</a>,
6867
Up: <a rel="up" accesskey="u" href="#Watchpoints">Watchpoints</a>
8027
6868
</small>
8028
6869
8029
<br>
6870
8030
6871
</div>
8031
6872
8032
<h4 class="subsection">Deleting Watchpoints</h4>
6873
<h4 class="subsection">5.2.4 Deleting Watchpoints</h4>
8033
6874
8034
<p>To delete a watchpoint, enter the name of the watched variable in the
8035
argument field and click the <code>Unwatch</code> button.
6875
<p><a name="index-Watchpoint_002c-deleting-723"></a>
6876
To delete a watchpoint, enter the name of the watched variable in the
6877
argument field and click the ‘<samp><span class="samp">Unwatch</span></samp>’ button.
8036
6878
8037
6879
<div class="node">
8038
6880
<p><hr>
8039
<small class=header>
8040
Node:<a name="Interrupting">Interrupting</a>,
8041
Next:<a rel="next" accesskey="n" href="#Stopping%20X%20Programs">Stopping X Programs</a>,
8042
Previous:<a rel="previous" accesskey="p" href="#Watchpoints">Watchpoints</a>,
8043
Up:<a rel="up" accesskey="u" href="#Stopping">Stopping</a>
6881
<a name="Interrupting"></a>
6882
Next: <a rel="next" accesskey="n" href="#Stopping-X-Programs">Stopping X Programs</a>,
6883
Previous: <a rel="previous" accesskey="p" href="#Watchpoints">Watchpoints</a>,
6884
Up: <a rel="up" accesskey="u" href="#Stopping">Stopping</a>
8044
6885
</small>
8045
6886
8046
<br>
6887
8047
6888
</div>
8048
6889
8049
<h3 class="section">Interrupting</h3>
6890
<h3 class="section">5.3 Interrupting</h3>
8050
6891
8051
<p>If the program is already running (see <a href="#Running">Running</a>), you can interrupt
8052
it any time by clicking the <code>Interrupt</code> button or typing <ESC>
8053
in a <small>DDD</small> window.<a rel="footnote" href="#fn-19"><sup>19</sup></a> Using <small>GDB</small>, this is
6892
<p><a name="index-Interrupt-724"></a><a name="index-ESC-725"></a><a name="index-Ctrl_002bC-726"></a><a name="index-SIGINT-signal-727"></a>If the program is already running (see <a href="#Running">Running</a>), you can interrupt
6893
it any time by clicking the ‘<samp><span class="samp">Interrupt</span></samp>’ button or typing <ESC>
6894
in a <acronym>DDD</acronym> window.<a rel="footnote" href="#fn-19" name="fnd-19"><sup>19</sup></a> Using <acronym>GDB</acronym>, this is
8054
6895
equivalent to sending a <code>SIGINT</code> (Interrupt) signal.
8055
6896
8056
<p><code>Interrupt</code> and <ESC> also interrupt a running debugger
6897
<p>‘<samp><span class="samp">Interrupt</span></samp>’ and <ESC> also interrupt a running debugger
8057
6898
command, such as printing data.
8058
6899
8059
6900
<div class="node">
8060
6901
<p><hr>
8061
<small class=header>
8062
Node:<a name="Stopping%20X%20Programs">Stopping X Programs</a>,
8063
Previous:<a rel="previous" accesskey="p" href="#Interrupting">Interrupting</a>,
8064
Up:<a rel="up" accesskey="u" href="#Stopping">Stopping</a>
6902
<a name="Stopping-X-Programs"></a>
6903
Previous: <a rel="previous" accesskey="p" href="#Interrupting">Interrupting</a>,
6904
Up: <a rel="up" accesskey="u" href="#Stopping">Stopping</a>
8065
6905
</small>
8066
6906
8067
<br>
6907
8068
6908
</div>
8069
6909
8070
<h3 class="section">Stopping X Programs</h3>
6910
<h3 class="section">5.4 Stopping X Programs</h3>
8071
6911
8072
<p>If your program is a modal X application, <small>DDD</small> may interrupt it
6912
<p><a name="index-X-programs_002c-stopping-728"></a><a name="index-X-server_002c-frozen-729"></a><a name="index-Mouse-pointer_002c-frozen-730"></a><a name="index-Display_002c-frozen-731"></a><a name="index-Grabbed-pointer-732"></a>
6913
If your program is a modal X application, <acronym>DDD</acronym> may interrupt it
8073
6914
while it has grabbed the mouse pointer, making further interaction
8074
impossible--your X display will be unresponsive to any user actions.
6915
impossible—your X display will be unresponsive to any user actions.
8075
6916
8076
<p>By default, <small>DDD</small> will check after each interaction whether the
8077
pointer is grabbed. If the pointer is grabbed, <small>DDD</small> will
6917
<p>By default, <acronym>DDD</acronym> will check after each interaction whether the
6918
pointer is grabbed. If the pointer is grabbed, <acronym>DDD</acronym> will
8078
6919
continue the debugged program such that you can continue to use your X
8079
6920
display.
8080
6921
8081
<p>This is how this feature works: When the program stops, <small>DDD</small>
6922
<p>This is how this feature works: When the program stops, <acronym>DDD</acronym>
8082
6923
checks for input events such as keyboard or mouse interaction. If
8083
<small>DDD</small> does not receive any event within the next 5 seconds,
8084
<small>DDD</small> checks whether the mouse pointer is grabbed by attempting to
8085
grab and ungrab it. If this attempt fails, then <small>DDD</small> considers
6924
<acronym>DDD</acronym> does not receive any event within the next 5 seconds,
6925
<acronym>DDD</acronym> checks whether the mouse pointer is grabbed by attempting to
6926
grab and ungrab it. If this attempt fails, then <acronym>DDD</acronym> considers
8086
6927
the pointer grabbed.
8087
6928
8088
<p>Unfortunately, <small>DDD</small> cannot determine the program that grabbed the
8089
pointer--it may be the debugged program, or another program.
6929
<p>Unfortunately, <acronym>DDD</acronym> cannot determine the program that grabbed the
6930
pointer—it may be the debugged program, or another program.
8090
6931
Consequently, you have another 10 seconds to cancel continuation before
8091
<small>DDD</small> continues the program automatically.
6932
<acronym>DDD</acronym> continues the program automatically.
8092
6933
8093
<p>There is one situation where this fails: if you lock your X display
8094
while <small>DDD</small> is running, then <small>DDD</small> will consider a resulting pointer
8095
grab as a result of running the program--and automatically continue
6934
<p><a name="index-X-server_002c-locked-733"></a><a name="index-Display_002c-locked-734"></a><a name="index-Continue-Automatically-when-Mouse-Pointer-is-Frozen-735"></a>There is one situation where this fails: if you lock your X display
6935
while <acronym>DDD</acronym> is running, then <acronym>DDD</acronym> will consider a resulting pointer
6936
grab as a result of running the program—and automatically continue
8096
6937
execution of the debugged program. Consequently, you can turn off this
8097
feature via <code>Edit => Preferences => General =>
8098
Continue Automatically when Mouse Pointer is Frozen</code>.
6938
feature via ‘<samp><span class="samp">Edit Preferences General
6939
Continue Automatically when Mouse Pointer is Frozen</span></samp>’.
8099
6940
8100
6941
<ul class="menu">
8101
<li><a accesskey="1" href="#Customizing%20Grab%20Checking">Customizing Grab Checking</a>:
6942
<li><a accesskey="1" href="#Customizing-Grab-Checking">Customizing Grab Checking</a>
8102
6943
</ul>
8103
6944
8104
6945
<div class="node">
8105
6946
<p><hr>
8106
<small class=header>
8107
Node:<a name="Customizing%20Grab%20Checking">Customizing Grab Checking</a>,
8108
Up:<a rel="up" accesskey="u" href="#Stopping%20X%20Programs">Stopping X Programs</a>
6947
<a name="Customizing-Grab-Checking"></a>
6948
Up: <a rel="up" accesskey="u" href="#Stopping-X-Programs">Stopping X Programs</a>
8109
6949
</small>
8110
6950
8111
<br>
6951
8112
6952
</div>
8113
6953
8114
<h4 class="subsection">Customizing Grab Checking</h4>
8115
8116
<p>The grab checks are controlled by the following resources:
8117
8118
<p>
8119
<table width="100%">
8120
<tr>
8121
<td align="left"><b>checkGrabs</b><i> </i>(<i>class CheckGrabs</i>)<i>
8122
</i></td>
8123
<td align="right">Resource</td>
8124
</tr>
8125
</table>
8126
<table width="95%" align="center">
8127
<tr><td>
8128
If this is <code>on</code> (default), <small>DDD</small> will check after each
8129
interaction whether the pointer is grabbed. If this is so, <small>DDD</small>
6954
<h4 class="subsection">5.4.1 Customizing Grab Checking</h4>
6955
6956
<p>The grab checks are controlled by the following resources:
6957
6958
<div class="defun">
6959
— Resource: <b>checkGrabs</b> (<var>class CheckGrabs</var>)<var><a name="index-checkGrabs-736"></a></var><br>
6960
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’ (default), <acronym>DDD</acronym> will check after each
6961
interaction whether the pointer is grabbed. If this is so, <acronym>DDD</acronym>
8130
6962
will automatically continue execution of debugged program.
8131
</td></tr>
8132
</table>
6963
</p></blockquote></div>
8133
6964
8134
<p>
8135
<table width="100%">
8136
<tr>
8137
<td align="left"><b>checkGrabDelay</b><i> </i>(<i>class CheckGrabDelay</i>)<i>
8138
</i></td>
8139
<td align="right">Resource</td>
8140
</tr>
8141
</table>
8142
<table width="95%" align="center">
8143
<tr><td>
8144
The time to wait (in ms) after a debugger command before checking for a
8145
grabbed pointer. If <small>DDD</small> sees some pointer event within this
6965
<div class="defun">
6966
— Resource: <b>checkGrabDelay</b> (<var>class CheckGrabDelay</var>)<var><a name="index-checkGrabDelay-737"></a></var><br>
6967
<blockquote><p>The time to wait (in ms) after a debugger command before checking for a
6968
grabbed pointer. If <acronym>DDD</acronym> sees some pointer event within this
8146
6969
delay, the pointer cannot be grabbed and an explicit check for a grabbed
8147
6970
pointer is unnecessary. Default is <code>5000</code>, or 5 seconds.
8148
</td></tr>
8149
</table>
6971
</p></blockquote></div>
8150
6972
8151
<p>
8152
<table width="100%">
8153
<tr>
8154
<td align="left"><b>grabAction</b><i> </i>(<i>class grabAction</i>)<i>
8155
</i></td>
8156
<td align="right">Resource</td>
8157
</tr>
8158
</table>
8159
<table width="95%" align="center">
8160
<tr><td>
8161
The action to take after having detected a grabbed mouse pointer.
6973
<div class="defun">
6974
— Resource: <b>grabAction</b> (<var>class grabAction</var>)<var><a name="index-grabAction-738"></a></var><br>
6975
<blockquote><p><a name="index-cont-739"></a><a name="index-kill-740"></a><a name="index-quit-741"></a>The action to take after having detected a grabbed mouse pointer.
8162
6976
This is a list of newline-separated commands. Default is
8163
<code>cont</code>, meaning to continue the debuggee. Other possible
8164
choices include <code>kill</code> (killing the debuggee) or <code>quit</code>
8165
(exiting <small>DDD</small>).
8166
</td></tr>
8167
</table>
6977
<samp><span class="command">cont</span></samp>, meaning to continue the debuggee. Other possible
6978
choices include <samp><span class="command">kill</span></samp> (killing the debuggee) or <samp><span class="command">quit</span></samp>
6979
(exiting <acronym>DDD</acronym>).
6980
</p></blockquote></div>
8168
6981
8169
<p>
8170
<table width="100%">
8171
<tr>
8172
<td align="left"><b>grabActionDelay</b><i> </i>(<i>class grabActionDelay</i>)<i>
8173
</i></td>
8174
<td align="right">Resource</td>
8175
</tr>
8176
</table>
8177
<table width="95%" align="center">
8178
<tr><td>
8179
The time to wait (in ms) before taking an action due to having
6982
<div class="defun">
6983
— Resource: <b>grabActionDelay</b> (<var>class grabActionDelay</var>)<var><a name="index-grabActionDelay-742"></a></var><br>
6984
<blockquote><p>The time to wait (in ms) before taking an action due to having
8180
6985
detected a grabbed pointer. During this delay, a working dialog pops
8181
6986
up telling the user about imminent execution of the grab action (see
8182
the <code>grabAction</code> resource, above). If the pointer grab is
6987
the ‘<samp><span class="samp">grabAction</span></samp>’ resource, above). If the pointer grab is
8183
6988
released within this delay, the working dialog pops down and no action
8184
6989
is taken. This is done to exclude pointer grabs from sources other
8185
than the debugged program (including <small>DDD</small>). Default is
6990
than the debugged program (including <acronym>DDD</acronym>). Default is
8186
6991
<code>10000</code>, or 10 seconds.
8187
</td></tr>
8188
</table>
6992
</p></blockquote></div>
8189
6993
8190
6994
<div class="node">
8191
6995
<p><hr>
8192
<small class=header>
8193
Node:<a name="Running">Running</a>,
8194
Next:<a rel="next" accesskey="n" href="#Examining%20Data">Examining Data</a>,
8195
Previous:<a rel="previous" accesskey="p" href="#Stopping">Stopping</a>,
8196
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
6996
<a name="Running"></a>
6997
Next: <a rel="next" accesskey="n" href="#Examining-Data">Examining Data</a>,
6998
Previous: <a rel="previous" accesskey="p" href="#Stopping">Stopping</a>,
6999
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
8197
7000
</small>
8198
7001
8199
<br>
7002
8200
7003
</div>
8201
7004
8202
<h2 class="chapter">Running the Program</h2>
7005
<h2 class="chapter">6 Running the Program</h2>
8203
7006
8204
<p>You may start the debugged program with its arguments, if any, in an
7007
<p><a name="index-Running-the-debugged-program-743"></a>
7008
You may start the debugged program with its arguments, if any, in an
8205
7009
environment of your choice. You may redirect your program's input and
8206
7010
output, debug an already running process, or kill a child process.
8207
7011
8208
7012
<ul class="menu">
8209
<li><a accesskey="1" href="#Starting%20Program%20Execution">Starting Program Execution</a>:
8210
<li><a accesskey="2" href="#Using%20the%20Execution%20Window">Using the Execution Window</a>:
8211
<li><a accesskey="3" href="#Attaching%20to%20a%20Process">Attaching to a Process</a>:
8212
<li><a accesskey="4" href="#Program%20Stop">Program Stop</a>:
8213
<li><a accesskey="5" href="#Resuming%20Execution">Resuming Execution</a>:
8214
<li><a accesskey="6" href="#Continuing%20Somewhere%20Else">Continuing Somewhere Else</a>:
8215
<li><a accesskey="7" href="#Stack">Stack</a>:
8216
<li><a accesskey="8" href="#Undoing%20Program%20Execution">Undoing Program Execution</a>:
8217
<li><a accesskey="9" href="#Threads">Threads</a>:
8218
<li><a href="#Signals">Signals</a>:
8219
<li><a href="#Killing%20the%20Program">Killing the Program</a>:
7013
<li><a accesskey="1" href="#Starting-Program-Execution">Starting Program Execution</a>
7014
<li><a accesskey="2" href="#Using-the-Execution-Window">Using the Execution Window</a>
7015
<li><a accesskey="3" href="#Attaching-to-a-Process">Attaching to a Process</a>
7016
<li><a accesskey="4" href="#Program-Stop">Program Stop</a>
7017
<li><a accesskey="5" href="#Resuming-Execution">Resuming Execution</a>
7018
<li><a accesskey="6" href="#Continuing-Somewhere-Else">Continuing Somewhere Else</a>
7019
<li><a accesskey="7" href="#Stack">Stack</a>
7020
<li><a accesskey="8" href="#Undoing-Program-Execution">Undoing Program Execution</a>
7021
<li><a accesskey="9" href="#Threads">Threads</a>
7022
<li><a href="#Signals">Signals</a>
7023
<li><a href="#Killing-the-Program">Killing the Program</a>
8220
7024
</ul>
8221
7025
8222
7026
<div class="node">
8223
7027
<p><hr>
8224
<small class=header>
8225
Node:<a name="Starting%20Program%20Execution">Starting Program Execution</a>,
8226
Next:<a rel="next" accesskey="n" href="#Using%20the%20Execution%20Window">Using the Execution Window</a>,
8227
Up:<a rel="up" accesskey="u" href="#Running">Running</a>
7028
<a name="Starting-Program-Execution"></a>
7029
Next: <a rel="next" accesskey="n" href="#Using-the-Execution-Window">Using the Execution Window</a>,
7030
Up: <a rel="up" accesskey="u" href="#Running">Running</a>
8228
7031
</small>
8229
7032
8230
<br>
7033
8231
7034
</div>
8232
7035
8233
<h3 class="section">Starting Program Execution</h3>
7036
<h3 class="section">6.1 Starting Program Execution</h3>
8234
7037
8235
<p>To start execution of the debugged program, select <code>Program
8236
=> Run</code>. You will then be prompted for the arguments to pass to
7038
<p><a name="index-Arguments_002c-program-744"></a><a name="index-Program-arguments-745"></a>
7039
<a name="index-Run-746"></a>To start execution of the debugged program, select ‘<samp><span class="samp">Program
7040
Run</span></samp>’. You will then be prompted for the arguments to pass to
8237
7041
your program. You can either select from a list of previously used
8238
7042
arguments or enter own arguments in the text field. Afterwards, press
8239
the <code>Run</code> button to start execution with the selected arguments.
8240
8241
<br><p>
7043
the ‘<samp><span class="samp">Run</span></samp>’ button to start execution with the selected arguments.
7044
7045
<pre class="sp">
7046
7047
</pre>
8242
7048
<div align="center"><img src="PICS/ddd-arguments.jpg" alt="PICS/ddd-arguments.jpg"></div>
8243
<br><p>
8244
<p>To run your program again, with the same arguments, select <code>Program
8245
=> Run Again</code> or press the <code>Run</code> button on the command tool.
8246
You may also enter <code>run</code>, followed by arguments at the debugger
7049
<pre class="sp">
7050
7051
</pre>
7052
7053
<a name="index-run-747"></a><a name="index-Run-748"></a><a name="index-Run-Again-749"></a>To run your program again, with the same arguments, select ‘<samp><span class="samp">Program
7054
Run Again</span></samp>’ or press the ‘<samp><span class="samp">Run</span></samp>’ button on the command tool.
7055
You may also enter <samp><span class="command">run</span></samp>, followed by arguments at the debugger
8247
7056
prompt instead.
8248
7057
8249
<p>When you click on <code>Run</code>, your program begins to execute
7058
<p>When you click on ‘<samp><span class="samp">Run</span></samp>’, your program begins to execute
8250
7059
immediately. See <a href="#Stopping">Stopping</a>, for a discussion of how to arrange for
8251
7060
your program to stop. Once your program has stopped, you may call
8252
functions in your program to examine data. See <a href="#Examining%20Data">Examining Data</a>, for
7061
functions in your program to examine data. See <a href="#Examining-Data">Examining Data</a>, for
8253
7062
details.
8254
7063
8255
7064
<p>If the modification time of your symbol file has changed since the last
8256
time <small>GDB</small> read its symbols, <small>GDB</small> discards its symbol table, and reads it
8257
again. When it does this, <small>GDB</small> and <small>DDD</small> try to retain your
7065
time <acronym>GDB</acronym> read its symbols, <acronym>GDB</acronym> discards its symbol table, and reads it
7066
again. When it does this, <acronym>GDB</acronym> and <acronym>DDD</acronym> try to retain your
8258
7067
current debugger state, such as breakpoints.
8259
7068
8260
7069
<ul class="menu">
8261
7070
<li><a accesskey="1" href="#Arguments">Arguments</a>: Your program's arguments.
8262
7071
<li><a accesskey="2" href="#Environment">Environment</a>: Your program's environment.
8263
<li><a accesskey="3" href="#Working%20Directory">Working Directory</a>: Your program's directory.
8264
<li><a accesskey="4" href="#Input%2fOutput">Input/Output</a>: Your program's I/O.
7072
<li><a accesskey="3" href="#Working-Directory">Working Directory</a>: Your program's directory.
7073
<li><a accesskey="4" href="#Input_002fOutput">Input/Output</a>: Your program's I/O.
8265
7074
</ul>
8266
7075
8267
7076
<div class="node">
8268
7077
<p><hr>
8269
<small class=header>
8270
Node:<a name="Arguments">Arguments</a>,
8271
Next:<a rel="next" accesskey="n" href="#Environment">Environment</a>,
8272
Up:<a rel="up" accesskey="u" href="#Starting%20Program%20Execution">Starting Program Execution</a>
7078
<a name="Arguments"></a>
7079
Next: <a rel="next" accesskey="n" href="#Environment">Environment</a>,
7080
Up: <a rel="up" accesskey="u" href="#Starting-Program-Execution">Starting Program Execution</a>
8273
7081
</small>
8274
7082
8275
<br>
7083
8276
7084
</div>
8277
7085
8278
<h4 class="subsection">Your Program's Arguments</h4>
8279
8280
<p>The arguments to your program are specified by the arguments of the
8281
<code>run</code> command, as composed in <code>Program => Run</code>.
8282
8283
<p>In <small>GDB</small>, the arguments are passed to a shell, which expands wildcard
7086
<h4 class="subsection">6.1.1 Your Program's Arguments</h4>
7087
7088
<p><a name="index-Arguments_002c-of-the-debugged-program-750"></a>
7089
The arguments to your program are specified by the arguments of the
7090
‘<samp><span class="samp">run</span></samp>’ command, as composed in ‘<samp><span class="samp">Program Run</span></samp>’.
7091
7092
<p><a name="index-SHELL-751"></a>In <acronym>GDB</acronym>, the arguments are passed to a shell, which expands wildcard
8284
7093
characters and performs redirection of I/O, and thence to your program.
8285
Your <code>SHELL</code> environment variable (if it exists) specifies what
8286
shell <small>GDB</small> uses. If you do not define <code>SHELL</code>, <small>GDB</small> uses
8287
<code>/bin/sh</code>.
7094
Your <samp><span class="env">SHELL</span></samp> environment variable (if it exists) specifies what
7095
shell <acronym>GDB</acronym> uses. If you do not define <samp><span class="env">SHELL</span></samp>, <acronym>GDB</acronym> uses
7096
‘<samp><span class="samp">/bin/sh</span></samp>’.
8288
7097
8289
7098
<p>If you use another inferior debugger, the exact semantics on how the
8290
7099
arguments are interpreted depend on the inferior debugger you are using.
8294
7103
8295
7104
<div class="node">
8296
7105
<p><hr>
8297
<small class=header>
8298
Node:<a name="Environment">Environment</a>,
8299
Next:<a rel="next" accesskey="n" href="#Working%20Directory">Working Directory</a>,
8300
Previous:<a rel="previous" accesskey="p" href="#Arguments">Arguments</a>,
8301
Up:<a rel="up" accesskey="u" href="#Starting%20Program%20Execution">Starting Program Execution</a>
7106
<a name="Environment"></a>
7107
Next: <a rel="next" accesskey="n" href="#Working-Directory">Working Directory</a>,
7108
Previous: <a rel="previous" accesskey="p" href="#Arguments">Arguments</a>,
7109
Up: <a rel="up" accesskey="u" href="#Starting-Program-Execution">Starting Program Execution</a>
8302
7110
</small>
8303
7111
8304
<br>
7112
8305
7113
</div>
8306
7114
8307
<h4 class="subsection">Your Program's Environment</h4>
7115
<h4 class="subsection">6.1.2 Your Program's Environment</h4>
8308
7116
8309
<p>Your program normally inherits its environment from the inferior
8310
debugger, which again inherits it from <small>DDD</small>, which again inherits
7117
<p><a name="index-Environment_002c-of-the-debugged-program-752"></a>
7118
Your program normally inherits its environment from the inferior
7119
debugger, which again inherits it from <acronym>DDD</acronym>, which again inherits
8311
7120
it from its parent process (typically the shell or desktop).
8312
7121
8313
<p>In <small>GDB</small>, you can use the commands <code>set environment</code> and
8314
<code>unset environment</code> to change parts of the environment that
8315
affect your program. See <a href="gdb.html#Your%20program's%20environment">Your program's environment</a>,
7122
<p><a name="index-unset-environment-753"></a><a name="index-set-environment-754"></a>In <acronym>GDB</acronym>, you can use the commands <samp><span class="command">set environment</span></samp> and
7123
<samp><span class="command">unset environment</span></samp> to change parts of the environment that
7124
affect your program. See <a href="gdb.html#Your-program_0027s-environment">Your program's environment</a>,
8316
7125
for details.
8317
7126
8318
<p>The following environment variables are set by <small>DDD</small>:
7127
<p>The following environment variables are set by <acronym>DDD</acronym>:
8319
7128
8320
7129
<dl>
8321
<dt><code>DDD</code>
8322
<dd>Set to a string indicating the <small>DDD</small> version. By testing
8323
whether <code>DDD</code> is set, a debuggee (or inferior debugger) can
8324
determine whether it was invoked by <small>DDD</small>.
8325
8326
<br><dt><code>TERM</code>
8327
<dd>Set to <code>dumb</code>, the <small>DDD</small> terminal type. This is set for the
8328
inferior debugger only.<a rel="footnote" href="#fn-20"><sup>20</sup></a>
8329
8330
<br><dt><code>TERMCAP</code>
8331
<dd>Set to `' (none), the <small>DDD</small> terminal capabilities.
8332
8333
<br><dt><code>PAGER</code>
8334
<dd>Set to <code>cat</code>, the preferred <small>DDD</small> pager.
7130
<dt><samp><span class="env">DDD</span></samp><dd><a name="index-DDD-755"></a>Set to a string indicating the <acronym>DDD</acronym> version. By testing
7131
whether <samp><span class="env">DDD</span></samp> is set, a debuggee (or inferior debugger) can
7132
determine whether it was invoked by <acronym>DDD</acronym>.
7133
7134
<br><dt><samp><span class="env">TERM</span></samp><dd><a name="index-TERM-756"></a>Set to ‘<samp><span class="samp">dumb</span></samp>’, the <acronym>DDD</acronym> terminal type. This is set for the
7135
inferior debugger only.<a rel="footnote" href="#fn-20" name="fnd-20"><sup>20</sup></a>
7136
7137
<br><dt><samp><span class="env">TERMCAP</span></samp><dd><a name="index-TERMCAP-757"></a>Set to `' (none), the <acronym>DDD</acronym> terminal capabilities.
7138
7139
<br><dt><samp><span class="env">PAGER</span></samp><dd><a name="index-PAGER-758"></a>Set to ‘<samp><span class="samp">cat</span></samp>’, the preferred <acronym>DDD</acronym> pager.
8335
7140
</dl>
8336
7141
8337
7142
<p>The inferior debugger, in turn, might also set or unset some environment
8339
7144
8340
7145
<div class="node">
8341
7146
<p><hr>
8342
<small class=header>
8343
Node:<a name="Working%20Directory">Working Directory</a>,
8344
Next:<a rel="next" accesskey="n" href="#Input%2fOutput">Input/Output</a>,
8345
Previous:<a rel="previous" accesskey="p" href="#Environment">Environment</a>,
8346
Up:<a rel="up" accesskey="u" href="#Starting%20Program%20Execution">Starting Program Execution</a>
7147
<a name="Working-Directory"></a>
7148
Next: <a rel="next" accesskey="n" href="#Input_002fOutput">Input/Output</a>,
7149
Previous: <a rel="previous" accesskey="p" href="#Environment">Environment</a>,
7150
Up: <a rel="up" accesskey="u" href="#Starting-Program-Execution">Starting Program Execution</a>
8347
7151
</small>
8348
7152
8349
<br>
7153
8350
7154
</div>
8351
7155
8352
<h4 class="subsection">Your Program's Working Directory</h4>
7156
<h4 class="subsection">6.1.3 Your Program's Working Directory</h4>
8353
7157
8354
<p>Your program normally inherits its working directory from the inferior
8355
debugger, which again inherits it from <small>DDD</small>, which again inherits
7158
<p><a name="index-Working-directory_002c-of-the-debugged-program-759"></a><a name="index-Directory_002c-of-the-debugged-program-760"></a>
7159
Your program normally inherits its working directory from the inferior
7160
debugger, which again inherits it from <acronym>DDD</acronym>, which again inherits
8356
7161
it from its parent process (typically the shell or desktop).
8357
7162
8358
<p>You can change the working directory of the inferior debugger via
8359
<code>File => Change Directory</code> or via the <code>cd</code> command of
7163
<p><a name="index-Change-Directory-761"></a>You can change the working directory of the inferior debugger via
7164
‘<samp><span class="samp">File Change Directory</span></samp>’ or via the ‘<samp><span class="samp">cd</span></samp>’ command of
8360
7165
the inferior debugger.
8361
7166
8362
7167
<div class="node">
8363
7168
<p><hr>
8364
<small class=header>
8365
Node:<a name="Input%2fOutput">Input/Output</a>,
8366
Previous:<a rel="previous" accesskey="p" href="#Working%20Directory">Working Directory</a>,
8367
Up:<a rel="up" accesskey="u" href="#Starting%20Program%20Execution">Starting Program Execution</a>
7169
<a name="Input%2fOutput"></a>
7170
<a name="Input_002fOutput"></a>
7171
Previous: <a rel="previous" accesskey="p" href="#Working-Directory">Working Directory</a>,
7172
Up: <a rel="up" accesskey="u" href="#Starting-Program-Execution">Starting Program Execution</a>
8368
7173
</small>
8369
7174
8370
<br>
7175
8371
7176
</div>
8372
7177
8373
<h4 class="subsection">Your Program's Input and Output</h4>
7178
<h4 class="subsection">6.1.4 Your Program's Input and Output</h4>
8374
7179
8375
<p>By default, the program you run under <small>DDD</small> does input and output to
7180
<p><a name="index-Input-of-the-debugged-program-762"></a><a name="index-Output-of-the-debugged-program-763"></a><a name="index-Redirecting-I_002fO-of-the-debugged-program-764"></a><a name="index-Redirection-765"></a>
7181
By default, the program you run under <acronym>DDD</acronym> does input and output to
8376
7182
the debugger console. Normally, you can redirect your program's input
8377
and/or output using <dfn>shell redirections</dfn> with the arguments--that
8378
is, additional arguments like <code>< </code><var>input</var><code></code> or <code>>
8379
</code><var>output</var><code></code>. You can enter these shell redirections just like other
7183
and/or output using <dfn>shell redirections</dfn> with the arguments—that
7184
is, additional arguments like ‘<samp><span class="samp">< </span><var>input</var></samp>’ or ‘<samp><span class="samp">>
7185
</span><var>output</var></samp>’. You can enter these shell redirections just like other
8380
7186
arguments (see <a href="#Arguments">Arguments</a>).
8381
7187
8382
<p><em>Warning:</em> While input and output redirection work, you cannot use
7188
<p><a name="index-Pipe-766"></a><em>Warning:</em> While input and output redirection work, you cannot use
8383
7189
pipes to pass the output of the program you are debugging to another
8384
program; if you attempt this, <small>DDD</small> may wind up debugging the wrong
8385
program. See <a href="#Attaching%20to%20a%20Process">Attaching to a Process</a>, for an alternative.
7190
program; if you attempt this, <acronym>DDD</acronym> may wind up debugging the wrong
7191
program. See <a href="#Attaching-to-a-Process">Attaching to a Process</a>, for an alternative.
8386
7192
8387
7193
<p>If command output is sent to the debugger console, it is impossible for
8388
<small>DDD</small> to distinguish between the output of the debugged program
7194
<acronym>DDD</acronym> to distinguish between the output of the debugged program
8389
7195
and the output of the inferior debugger.
8390
7196
8391
<p>Program output that confuses <small>DDD</small> includes:
7197
<p><a name="index-Program-output_002c-confusing-767"></a>Program output that confuses <acronym>DDD</acronym> includes:
8392
7198
8393
7199
<ul>
8394
<li>Primary debugger prompts (e.g. <code>(gdb) </code>, <code>(dbx) </code> or
8395
<code>(ladebug) </code>)
8396
8397
<li>Secondary debugger prompts (e.g. <code>></code>)
8398
8399
<li>Confirmation prompts (e.g. <code>(y or n) </code>)
8400
8401
<li>Prompts for more output (e.g. <code>Press RETURN to continue</code>)
8402
8403
<li>Display output (e.g. <code>$pc = 0x1234</code>)
7200
<li>Primary debugger prompts (e.g. ‘<samp><span class="samp">(gdb) </span></samp>’, ‘<samp><span class="samp">(dbx) </span></samp>’ or
7201
‘<samp><span class="samp">(ladebug) </span></samp>’)
7202
7203
<li>Secondary debugger prompts (e.g. ‘<samp><span class="samp">></span></samp>’)
7204
7205
<li>Confirmation prompts (e.g. ‘<samp><span class="samp">(y or n) </span></samp>’)
7206
7207
<li>Prompts for more output (e.g. ‘<samp><span class="samp">Press RETURN to continue</span></samp>’)
7208
7209
<li>Display output (e.g. ‘<samp><span class="samp">$pc = 0x1234</span></samp>’)
8404
7210
</ul>
8405
7211
8406
7212
<p>If your program outputs any of these strings, you may encounter problems
8407
with <small>DDD</small> mistaking them for debugger output. These problems can
7213
with <acronym>DDD</acronym> mistaking them for debugger output. These problems can
8408
7214
easily be avoided by redirecting program I/O, for instance to the
8409
separate execution window (see <a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>).
7215
separate execution window (see <a href="#Using-the-Execution-Window">Using the Execution Window</a>).
8410
7216
8411
<p>If the inferior debugger changes the default <small>TTY</small> settings, for
8412
instance through a <code>stty</code> command in its initialization file,
8413
<small>DDD</small> may also become confused. The same applies to debugged programs
8414
which change the default <small>TTY</small> settings.
7217
<p><a name="index-g_t_0040acronym_007bTTY_007d-settings-768"></a><a name="index-stty-769"></a>If the inferior debugger changes the default <acronym>TTY</acronym> settings, for
7218
instance through a <samp><span class="command">stty</span></samp> command in its initialization file,
7219
<acronym>DDD</acronym> may also become confused. The same applies to debugged programs
7220
which change the default <acronym>TTY</acronym> settings.
8415
7221
8416
7222
<p>The behavior of the debugger console can be controlled using the
8417
7223
following resource:
8418
7224
8419
<p>
8420
<table width="100%">
8421
<tr>
8422
<td align="left"><b>lineBufferedConsole</b><i> </i>(<i>class LineBuffered</i>)<i>
8423
</i></td>
8424
<td align="right">Resource</td>
8425
</tr>
8426
</table>
8427
<table width="95%" align="center">
8428
<tr><td>
8429
If this is <code>on</code> (default), each line from the inferior debugger is
7225
<div class="defun">
7226
— Resource: <b>lineBufferedConsole</b> (<var>class LineBuffered</var>)<var><a name="index-lineBufferedConsole-770"></a></var><br>
7227
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’ (default), each line from the inferior debugger is
8430
7228
output on each own, such that the final line is placed at the bottom of
8431
the debugger console. If this is <code>off</code>, all lines are output as a
7229
the debugger console. If this is ‘<samp><span class="samp">off</span></samp>’, all lines are output as a
8432
7230
whole. This is faster, but results in a random position of the last
8433
7231
line.
8434
</td></tr>
8435
</table>
7232
</p></blockquote></div>
8436
7233
8437
7234
<div class="node">
8438
7235
<p><hr>
8439
<small class=header>
8440
Node:<a name="Using%20the%20Execution%20Window">Using the Execution Window</a>,
8441
Next:<a rel="next" accesskey="n" href="#Attaching%20to%20a%20Process">Attaching to a Process</a>,
8442
Previous:<a rel="previous" accesskey="p" href="#Starting%20Program%20Execution">Starting Program Execution</a>,
8443
Up:<a rel="up" accesskey="u" href="#Running">Running</a>
7236
<a name="Using-the-Execution-Window"></a>
7237
Next: <a rel="next" accesskey="n" href="#Attaching-to-a-Process">Attaching to a Process</a>,
7238
Previous: <a rel="previous" accesskey="p" href="#Starting-Program-Execution">Starting Program Execution</a>,
7239
Up: <a rel="up" accesskey="u" href="#Running">Running</a>
8444
7240
</small>
8445
7241
8446
<br>
7242
8447
7243
</div>
8448
7244
8449
<h3 class="section">Using the Execution Window</h3>
7245
<h3 class="section">6.2 Using the Execution Window</h3>
8450
7246
8451
<p>By default, input and output of your program go to the debugger console.
8452
As an alternative, <small>DDD</small> can also invoke an <dfn>execution
7247
<p><a name="index-Execution-window-771"></a><a name="index-Redirecting-I_002fO-to-the-execution-window-772"></a>
7248
<a name="index-Run-in-Execution-Window-773"></a>By default, input and output of your program go to the debugger console.
7249
As an alternative, <acronym>DDD</acronym> can also invoke an <dfn>execution
8453
7250
window</dfn>, where the program terminal input and output is
8454
shown.<a rel="footnote" href="#fn-21"><sup>21</sup></a>
7251
shown.<a rel="footnote" href="#fn-21" name="fnd-21"><sup>21</sup></a>
8455
7252
8456
<p>To activate the execution window, select <code>Program => Run in
8457
Execution Window</code>.
7253
<p>To activate the execution window, select ‘<samp><span class="samp">Program Run in
7254
Execution Window</span></samp>’.
8458
7255
8459
7256
<p>Using the execution window has an important side effect: The output of
8460
7257
your program no longer gets intermixed with the output of the inferior
8461
debugger. This makes it far easier for <small>DDD</small> to parse the debugger
8462
output correctly. See <a href="#Debugger%20Communication">Debugger Communication</a>, for details on the
8463
<code>bufferGDBOutput</code> resource.
7258
debugger. This makes it far easier for <acronym>DDD</acronym> to parse the debugger
7259
output correctly. See <a href="#Debugger-Communication">Debugger Communication</a>, for details on the
7260
‘<samp><span class="samp">bufferGDBOutput</span></samp>’ resource.
8464
7261
8465
7262
<p>The execution window is opened automatically as soon as you start the
8466
debugged program. While the execution window is active, <small>DDD</small>
7263
debugged program. While the execution window is active, <acronym>DDD</acronym>
8467
7264
redirects the standard input, output, and error streams of your program
8468
to the execution window. Note that the device <code>/dev/tty</code> still
7265
to the execution window. Note that the device ‘<samp><span class="samp">/dev/tty</span></samp>’ still
8469
7266
refers to the debugger console, <em>not</em> the execution window.
8470
7267
8471
<p>You can override the <small>DDD</small> stream redirection by giving alternate
7268
<p><a name="index-Redirection_002c-to-execution-window-774"></a>You can override the <acronym>DDD</acronym> stream redirection by giving alternate
8472
7269
redirection operations as arguments. For instance, to have your program
8473
7270
read from <var>file</var>, but to write to the execution window, invoke your
8474
program with <code>< </code><var>file</var><code></code> as argument. Likewise, to redirect the
8475
standard error output to the debugger console, use <code>2> /dev/tty</code>
8476
(assuming the inferior debugger and/or your <small>UNIX</small> shell support standard
7271
program with ‘<samp><span class="samp">< </span><var>file</var></samp>’ as argument. Likewise, to redirect the
7272
standard error output to the debugger console, use ‘<samp><span class="samp">2> /dev/tty</span></samp>’
7273
(assuming the inferior debugger and/or your <acronym>UNIX</acronym> shell support standard
8477
7274
error redirection).
8478
7275
8479
7276
<ul class="menu">
8480
<li><a accesskey="1" href="#Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>:
7277
<li><a accesskey="1" href="#Customizing-the-Execution-Window">Customizing the Execution Window</a>
8481
7278
</ul>
8482
7279
8483
7280
<div class="node">
8484
7281
<p><hr>
8485
<small class=header>
8486
Node:<a name="Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>,
8487
Up:<a rel="up" accesskey="u" href="#Using%20the%20Execution%20Window">Using the Execution Window</a>
7282
<a name="Customizing-the-Execution-Window"></a>
7283
Up: <a rel="up" accesskey="u" href="#Using-the-Execution-Window">Using the Execution Window</a>
8488
7284
</small>
8489
7285
8490
<br>
7286
8491
7287
</div>
8492
7288
8493
<h4 class="subsection">Customizing the Execution Window</h4>
8494
8495
<p>You can customize the <small>DDD</small> execution window and use a different
8496
<small>TTY</small> command. The command is set by <code>Edit =>
8497
Preferences => Helpers => Execution Window</code>:
8498
8499
<p>
8500
<table width="100%">
8501
<tr>
8502
<td align="left"><b>termCommand</b><i> </i>(<i>class TermCommand</i>)<i>
8503
</i></td>
8504
<td align="right">Resource</td>
8505
</tr>
8506
</table>
8507
<table width="95%" align="center">
8508
<tr><td>
8509
The command to invoke for the execution window--a <small>TTY</small>
7289
<h4 class="subsection">6.2.1 Customizing the Execution Window</h4>
7290
7291
<p>You can customize the <acronym>DDD</acronym> execution window and use a different
7292
<acronym>TTY</acronym> command. The command is set by ‘<samp><span class="samp">Edit
7293
Preferences Helpers Execution Window</span></samp>’:
7294
<a name="index-Execution-Window-775"></a>
7295
7296
<div class="defun">
7297
— Resource: <b>termCommand</b> (<var>class TermCommand</var>)<var><a name="index-termCommand-776"></a></var><br>
7298
<blockquote><p>The command to invoke for the execution window—a <acronym>TTY</acronym>
8510
7299
emulator that shows the input/output of the debugged program. A Bourne
8511
shell command to run in the separate <small>TTY</small> is appended to this
8512
string. The string <code>@FONT@</code> is replaced by the name of the fixed
8513
width font used by <small>DDD</small>. A simple value is
7300
shell command to run in the separate <acronym>TTY</acronym> is appended to this
7301
string. The string ‘<samp><span class="samp">@FONT@</span></samp>’ is replaced by the name of the fixed
7302
width font used by <acronym>DDD</acronym>. A simple value is
8514
7303
8515
7304
<pre class="example"> Ddd*termCommand: xterm -fn @FONT@ -e /bin/sh -c
8516
</pre>
8517
</td></tr>
8518
</table>
7305
</pre>
7306
<p><a name="index-xterm-777"></a></p></blockquote></div>
8519
7307
8520
7308
<p>You can also set the terminal type:
8521
7309
8522
<p>
8523
<table width="100%">
8524
<tr>
8525
<td align="left"><b>termType</b><i> </i>(<i>class TermType</i>)<i>
8526
</i></td>
8527
<td align="right">Resource</td>
8528
</tr>
8529
</table>
8530
<table width="95%" align="center">
8531
<tr><td>
8532
The terminal type provided by the <code>termCommand</code> resource--that is,
8533
the value of the <code>TERM</code> environment variable to be passed to the
8534
debugged program. Default: <code>xterm</code>.
8535
</td></tr>
8536
</table>
8537
8538
<p>Whether the execution window is active or not, as set by <code>Program
8539
=> Run in Execution Window</code>, is saved using this resource:
8540
8541
<p>
8542
<table width="100%">
8543
<tr>
8544
<td align="left"><b>separateExecWindow</b><i> </i>(<i>class Separate</i>)<i>
8545
</i></td>
8546
<td align="right">Resource</td>
8547
</tr>
8548
</table>
8549
<table width="95%" align="center">
8550
<tr><td>
8551
If <code>on</code>, the debugged program is executed in a separate
8552
execution window. If <code>off</code> (default), the debugged program is
7310
<div class="defun">
7311
— Resource: <b>termType</b> (<var>class TermType</var>)<var><a name="index-termType-778"></a></var><br>
7312
<blockquote><p>The terminal type provided by the ‘<samp><span class="samp">termCommand</span></samp>’ resource—that is,
7313
the value of the <samp><span class="env">TERM</span></samp> environment variable to be passed to the
7314
debugged program. Default: ‘<samp><span class="samp">xterm</span></samp>’.
7315
<a name="index-TERM-779"></a></p></blockquote></div>
7316
7317
<p>Whether the execution window is active or not, as set by ‘<samp><span class="samp">Program
7318
Run in Execution Window</span></samp>’, is saved using this resource:
7319
7320
<div class="defun">
7321
— Resource: <b>separateExecWindow</b> (<var>class Separate</var>)<var><a name="index-separateExecWindow-780"></a></var><br>
7322
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, the debugged program is executed in a separate
7323
execution window. If ‘<samp><span class="samp">off</span></samp>’ (default), the debugged program is
8553
7324
executed in the console window.
8554
</td></tr>
8555
</table>
7325
</p></blockquote></div>
8556
7326
8557
7327
<div class="node">
8558
7328
<p><hr>
8559
<small class=header>
8560
Node:<a name="Attaching%20to%20a%20Process">Attaching to a Process</a>,
8561
Next:<a rel="next" accesskey="n" href="#Program%20Stop">Program Stop</a>,
8562
Previous:<a rel="previous" accesskey="p" href="#Using%20the%20Execution%20Window">Using the Execution Window</a>,
8563
Up:<a rel="up" accesskey="u" href="#Running">Running</a>
7329
<a name="Attaching-to-a-Process"></a>
7330
Next: <a rel="next" accesskey="n" href="#Program-Stop">Program Stop</a>,
7331
Previous: <a rel="previous" accesskey="p" href="#Using-the-Execution-Window">Using the Execution Window</a>,
7332
Up: <a rel="up" accesskey="u" href="#Running">Running</a>
8564
7333
</small>
8565
7334
8566
<br>
7335
8567
7336
</div>
8568
7337
8569
<h3 class="section">Attaching to a Running Process</h3>
7338
<h3 class="section">6.3 Attaching to a Running Process</h3>
8570
7339
8571
<p>If the debugged program is already running in some process, you can
7340
<p><a name="index-Process_002c-attaching-781"></a>
7341
If the debugged program is already running in some process, you can
8572
7342
<dfn>attach</dfn> to this process (instead of starting a new one with
8573
<code>Run</code>).<a rel="footnote" href="#fn-22"><sup>22</sup></a>
8574
8575
<p>To attach <small>DDD</small> to a process, select <code>File => Attach
8576
to Process</code>. You can now choose from a list of processes. Then, press
8577
the <code>Attach</code> button to attach to the specified process.
8578
8579
<br><p>
7343
‘<samp><span class="samp">Run</span></samp>’).<a rel="footnote" href="#fn-22" name="fnd-22"><sup>22</sup></a>
7344
7345
<p><a name="index-Attach-782"></a><a name="index-Attach-to-Process-783"></a>To attach <acronym>DDD</acronym> to a process, select ‘<samp><span class="samp">File Attach
7346
to Process</span></samp>’. You can now choose from a list of processes. Then, press
7347
the ‘<samp><span class="samp">Attach</span></samp>’ button to attach to the specified process.
7348
7349
<pre class="sp">
7350
7351
</pre>
8580
7352
<div align="center"><img src="PICS/ddd-attach.jpg" alt="PICS/ddd-attach.jpg"></div>
8581
<br><p>
8582
<p>The first thing <small>DDD</small> does after arranging to debug the specified
7353
<pre class="sp">
7354
7355
</pre>
7356
7357
<a name="index-Continuing-process-execution-784"></a>The first thing <acronym>DDD</acronym> does after arranging to debug the specified
8583
7358
process is to stop it. You can examine and modify an attached process
8584
with all the <small>DDD</small> commands that are ordinarily available when you
8585
start processes with <code>Run</code>. You can insert breakpoints; you can
7359
with all the <acronym>DDD</acronym> commands that are ordinarily available when you
7360
start processes with ‘<samp><span class="samp">Run</span></samp>’. You can insert breakpoints; you can
8586
7361
step and continue; you can modify storage. If you would rather the
8587
process continue running, you may use <code>Continue</code> after attaching
8588
<small>DDD</small> to the process.
7362
process continue running, you may use ‘<samp><span class="samp">Continue</span></samp>’ after attaching
7363
<acronym>DDD</acronym> to the process.
8589
7364
8590
<p>When using <code>Attach to Process</code>, you should first use <code>Open
8591
Program</code> to specify the program running in the process and load its
7365
<p><a name="index-Open-Program-785"></a>When using ‘<samp><span class="samp">Attach to Process</span></samp>’, you should first use ‘<samp><span class="samp">Open
7366
Program</span></samp>’ to specify the program running in the process and load its
8592
7367
symbol table.
8593
7368
8594
<p>When you have finished debugging the attached process, you can use the
8595
<code>File => Detach Process</code> to release it from <small>DDD</small>
7369
<p><a name="index-Detach-Process-786"></a>When you have finished debugging the attached process, you can use the
7370
‘<samp><span class="samp">File Detach Process</span></samp>’ to release it from <acronym>DDD</acronym>
8596
7371
control. Detaching the process continues its execution. After
8597
<code>Detach Process</code>, that process and <small>DDD</small> become
7372
‘<samp><span class="samp">Detach Process</span></samp>’, that process and <acronym>DDD</acronym> become
8598
7373
completely independent once more, and you are ready to attach another
8599
process or start one with <code>Run</code>.
7374
process or start one with ‘<samp><span class="samp">Run</span></samp>’.
8600
7375
8601
<p>You can customize the list of processes shown by defining an alternate
8602
command to list processes. See <code>Edit => Preferences
8603
=> Helpers => List Processes</code>; See <a href="#Customizing%20Attaching%20to%20Processes">Customizing Attaching to Processes</a>, for details.
7376
<p><a name="index-List-Processes-787"></a>You can customize the list of processes shown by defining an alternate
7377
command to list processes. See ‘<samp><span class="samp">Edit Preferences
7378
Helpers List Processes</span></samp>’; See <a href="#Customizing-Attaching-to-Processes">Customizing Attaching to Processes</a>, for details.
8604
7379
8605
7380
<ul class="menu">
8606
<li><a accesskey="1" href="#Customizing%20Attaching%20to%20Processes">Customizing Attaching to Processes</a>:
7381
<li><a accesskey="1" href="#Customizing-Attaching-to-Processes">Customizing Attaching to Processes</a>
8607
7382
</ul>
8608
7383
8609
7384
<div class="node">
8610
7385
<p><hr>
8611
<small class=header>
8612
Node:<a name="Customizing%20Attaching%20to%20Processes">Customizing Attaching to Processes</a>,
8613
Up:<a rel="up" accesskey="u" href="#Attaching%20to%20a%20Process">Attaching to a Process</a>
7386
<a name="Customizing-Attaching-to-Processes"></a>
7387
Up: <a rel="up" accesskey="u" href="#Attaching-to-a-Process">Attaching to a Process</a>
8614
7388
</small>
8615
7389
8616
<br>
7390
8617
7391
</div>
8618
7392
8619
<h4 class="subsection">Customizing Attaching to Processes</h4>
8620
8621
<p>When attaching to a process (see <a href="#Attaching%20to%20a%20Process">Attaching to a Process</a>),
8622
<small>DDD</small> uses a <code>ps</code> command to get the list of processes. This
8623
command is defined by the <code>psCommand</code> resource.
8624
8625
<p>
8626
<table width="100%">
8627
<tr>
8628
<td align="left"><b>psCommand</b><i> </i>(<i>class PsCommand</i>)<i>
8629
</i></td>
8630
<td align="right">Resource</td>
8631
</tr>
8632
</table>
8633
<table width="95%" align="center">
8634
<tr><td>
8635
The command to get a list of processes. Usually <code>ps</code>. Depending
8636
on your system, useful alternate values include <code>ps -ef</code> and
8637
<code>ps ux</code>. The first line of the output must either contain a
8638
<code>PID</code> title, or each line must begin with a process ID.
8639
8640
<p>Note that the output of this command is filtered by <small>DDD</small>; a
8641
process is only shown if it can be attached to. The <small>DDD</small>
7393
<h4 class="subsection">6.3.1 Customizing Attaching to Processes</h4>
7394
7395
<p>When attaching to a process (see <a href="#Attaching-to-a-Process">Attaching to a Process</a>),
7396
<acronym>DDD</acronym> uses a <samp><span class="command">ps</span></samp> command to get the list of processes. This
7397
command is defined by the ‘<samp><span class="samp">psCommand</span></samp>’ resource.
7398
7399
<div class="defun">
7400
— Resource: <b>psCommand</b> (<var>class PsCommand</var>)<var><a name="index-psCommand-788"></a></var><br>
7401
<blockquote><p><a name="index-ps-789"></a>The command to get a list of processes. Usually <samp><span class="command">ps</span></samp>. Depending
7402
on your system, useful alternate values include <samp><span class="command">ps -ef</span></samp> and
7403
<samp><span class="command">ps ux</span></samp>. The first line of the output must either contain a
7404
‘<samp><span class="samp">PID</span></samp>’ title, or each line must begin with a process ID.
7405
7406
<p>Note that the output of this command is filtered by <acronym>DDD</acronym>; a
7407
process is only shown if it can be attached to. The <acronym>DDD</acronym>
8642
7408
process itself as well as the process of the inferior debugger are
8643
7409
suppressed, too.
8644
</td></tr>
8645
</table>
7410
</p></blockquote></div>
8646
7411
8647
7412
<div class="node">
8648
7413
<p><hr>
8649
<small class=header>
8650
Node:<a name="Program%20Stop">Program Stop</a>,
8651
Next:<a rel="next" accesskey="n" href="#Resuming%20Execution">Resuming Execution</a>,
8652
Previous:<a rel="previous" accesskey="p" href="#Attaching%20to%20a%20Process">Attaching to a Process</a>,
8653
Up:<a rel="up" accesskey="u" href="#Running">Running</a>
7414
<a name="Program-Stop"></a>
7415
Next: <a rel="next" accesskey="n" href="#Resuming-Execution">Resuming Execution</a>,
7416
Previous: <a rel="previous" accesskey="p" href="#Attaching-to-a-Process">Attaching to a Process</a>,
7417
Up: <a rel="up" accesskey="u" href="#Running">Running</a>
8654
7418
</small>
8655
7419
8656
<br>
7420
8657
7421
</div>
8658
7422
8659
<h3 class="section">Program Stops</h3>
7423
<h3 class="section">6.4 Program Stops</h3>
8660
7424
8661
<p>After the program has been started, it runs until one of the following
7425
<p>After the program has been started, it runs until one of the following
8662
7426
happens:
8663
7427
8664
7428
<ul>
8673
7437
<li>Execution completes.
8674
7438
</ul>
8675
7439
8676
<p><small>DDD</small> shows the current program status in the debugger console.
7440
<p><acronym>DDD</acronym> shows the current program status in the debugger console.
8677
7441
The current execution position is highlighted by an arrow.
8678
7442
8679
<p>If <code>Edit => Preferences => General =>
8680
Uniconify When Ready</code> is set, <small>DDD</small> automatically deiconifies
8681
itself when the program stops. This way, you can iconify <small>DDD</small>
7443
<p><a name="index-Uniconify-When-Ready-790"></a>If ‘<samp><span class="samp">Edit Preferences General
7444
Uniconify When Ready</span></samp>’ is set, <acronym>DDD</acronym> automatically deiconifies
7445
itself when the program stops. This way, you can iconify <acronym>DDD</acronym>
8682
7446
during a lengthy computation and have it uniconify as soon as the
8683
7447
program stops.
8684
7448
8685
7449
<div class="node">
8686
7450
<p><hr>
8687
<small class=header>
8688
Node:<a name="Resuming%20Execution">Resuming Execution</a>,
8689
Next:<a rel="next" accesskey="n" href="#Continuing%20Somewhere%20Else">Continuing Somewhere Else</a>,
8690
Previous:<a rel="previous" accesskey="p" href="#Program%20Stop">Program Stop</a>,
8691
Up:<a rel="up" accesskey="u" href="#Running">Running</a>
7451
<a name="Resuming-Execution"></a>
7452
Next: <a rel="next" accesskey="n" href="#Continuing-Somewhere-Else">Continuing Somewhere Else</a>,
7453
Previous: <a rel="previous" accesskey="p" href="#Program-Stop">Program Stop</a>,
7454
Up: <a rel="up" accesskey="u" href="#Running">Running</a>
8692
7455
</small>
8693
7456
8694
<br>
7457
8695
7458
</div>
8696
7459
8697
<h3 class="section">Resuming Execution</h3>
8698
8699
<h4 class="subsection">Continuing</h4>
8700
8701
<p>To resume execution, at the current execution position, click on the
8702
<code>Continue</code> button. Any breakpoints set at the current execution
7460
<h3 class="section">6.5 Resuming Execution</h3>
7461
7462
<h4 class="subsection">6.5.1 Continuing</h4>
7463
7464
<p><a name="index-Continuing-execution-791"></a><a name="index-Execution_002c-continuing-792"></a>
7465
<a name="index-Continue-793"></a>To resume execution, at the current execution position, click on the
7466
‘<samp><span class="samp">Continue</span></samp>’ button. Any breakpoints set at the current execution
8703
7467
position are bypassed.
8704
7468
8705
<h4 class="subsection">Stepping one Line</h4>
7469
<h4 class="subsection">6.5.2 Stepping one Line</h4>
8706
7470
8707
<p>To execute just one source line, click on the <code>Step</code> button. The
7471
<p><a name="index-Execution_002c-one-line-794"></a><a name="index-Continue_002c-one-line-795"></a>
7472
<a name="index-Step-796"></a>To execute just one source line, click on the ‘<samp><span class="samp">Step</span></samp>’ button. The
8708
7473
program is executed until control reaches a different source line, which
8709
7474
may be in a different function. Then, the program is stopped and
8710
control returns to <small>DDD</small>.
7475
control returns to <acronym>DDD</acronym>.
8711
7476
8712
<p><em>Warning</em>: If you use the <code>Step</code> button while control is
7477
<p><em>Warning</em>: If you use the ‘<samp><span class="samp">Step</span></samp>’ button while control is
8713
7478
within a function that was compiled without debugging information,
8714
7479
execution proceeds until control reaches a function that does have
8715
7480
debugging information. Likewise, it will not step into a function which
8716
7481
is compiled without debugging information. To step through functions
8717
without debugging information, use the <code>Stepi</code> button
8718
(see <a href="#Machine%20Code%20Execution">Machine Code Execution</a>).
7482
without debugging information, use the ‘<samp><span class="samp">Stepi</span></samp>’ button
7483
(see <a href="#Machine-Code-Execution">Machine Code Execution</a>).
8719
7484
8720
<p>In <small>GDB</small>, the <code>Step</code> button only stops at the first instruction of a
7485
<p>In <acronym>GDB</acronym>, the ‘<samp><span class="samp">Step</span></samp>’ button only stops at the first instruction of a
8721
7486
source line. This prevents the multiple stops that used to occur in
8722
switch statements, for loops, etc. <code>Step</code> continues to stop if a
7487
switch statements, for loops, etc. ‘<samp><span class="samp">Step</span></samp>’ continues to stop if a
8723
7488
function that has debugging information is called within the line.
8724
7489
8725
<p>Also, the <code>Step</code> in <small>GDB</small> only enters a subroutine if there is line
7490
<p>Also, the ‘<samp><span class="samp">Step</span></samp>’ in <acronym>GDB</acronym> only enters a subroutine if there is line
8726
7491
number information for the subroutine. Otherwise it acts like the
8727
<code>Next</code> button.
8728
8729
<h4 class="subsection">Continuing to the Next Line</h4>
8730
8731
<p>To continue to the next line in the current function, click on the
8732
<code>Next</code> button. This is similar to <code>Step</code>, but any function
7492
‘<samp><span class="samp">Next</span></samp>’ button.
7493
7494
<h4 class="subsection">6.5.3 Continuing to the Next Line</h4>
7495
7496
<p><a name="index-Execution_002c-to-next-line-797"></a><a name="index-Continue_002c-to-next-line-798"></a>
7497
<a name="index-Next-799"></a>To continue to the next line in the current function, click on the
7498
‘<samp><span class="samp">Next</span></samp>’ button. This is similar to ‘<samp><span class="samp">Step</span></samp>’, but any function
8733
7499
calls appearing within the line of code are executed without stopping.
8734
7500
8735
7501
<p>Execution stops when control reaches a different line of code at the
8736
original stack level that was executing when you clicked on <code>Next</code>.
8737
8738
<h4 class="subsection">Continuing Until Here</h4>
8739
8740
<p>To continue running until a specific location is reached, use the
8741
<code>Continue Until Here</code> facility from the line popup menu.
8742
See <a href="#Temporary%20Breakpoints">Temporary Breakpoints</a>, for a discussion.
8743
8744
<h4 class="subsection">Continuing Until a Greater Line is Reached</h4>
8745
8746
<p>To continue until a greater line in the current function is reached,
8747
click on the <code>Until</code> button. This is useful to avoid single
7502
original stack level that was executing when you clicked on ‘<samp><span class="samp">Next</span></samp>’.
7503
7504
<h4 class="subsection">6.5.4 Continuing Until Here</h4>
7505
7506
<p><a name="index-Execution_002c-to-location-800"></a><a name="index-Continue_002c-to-location-801"></a>
7507
To continue running until a specific location is reached, use the
7508
‘<samp><span class="samp">Continue Until Here</span></samp>’ facility from the line popup menu.
7509
See <a href="#Temporary-Breakpoints">Temporary Breakpoints</a>, for a discussion.
7510
7511
<h4 class="subsection">6.5.5 Continuing Until a Greater Line is Reached</h4>
7512
7513
<p><a name="index-Execution_002c-until-greater-line-is-reached-802"></a><a name="index-Continue_002c-until-greater-line-is-reached-803"></a>
7514
<a name="index-Until-804"></a>To continue until a greater line in the current function is reached,
7515
click on the ‘<samp><span class="samp">Until</span></samp>’ button. This is useful to avoid single
8748
7516
stepping through a loop more than once.
8749
7517
8750
<p><code>Until</code> is like <code>Next</code>, except that when <code>Until</code>
7518
<p>‘<samp><span class="samp">Until</span></samp>’ is like ‘<samp><span class="samp">Next</span></samp>’, except that when ‘<samp><span class="samp">Until</span></samp>’
8751
7519
encounters a jump, it automatically continues execution until the
8752
7520
program counter is greater than the address of the jump.
8753
7521
8754
7522
<p>This means that when you reach the end of a loop after single stepping
8755
though it, <code>until</code> makes your program continue execution until it
8756
exits the loop. In contrast, clicking on <code>Next</code> at the end of a
7523
though it, ‘<samp><span class="samp">until</span></samp>’ makes your program continue execution until it
7524
exits the loop. In contrast, clicking on ‘<samp><span class="samp">Next</span></samp>’ at the end of a
8757
7525
loop simply steps back to the beginning of the loop, which forces you to
8758
7526
step through the next iteration.
8759
7527
8760
<p><code>Until</code> always stops your program if it attempts to exit the
7528
<p>‘<samp><span class="samp">Until</span></samp>’ always stops your program if it attempts to exit the
8761
7529
current stack frame.
8762
7530
8763
<p><code>Until</code> works by means of single instruction stepping, and hence is
7531
<p>‘<samp><span class="samp">Until</span></samp>’ works by means of single instruction stepping, and hence is
8764
7532
slower than continuing until a breakpoint is reached.
8765
7533
8766
<h4 class="subsection">Continuing Until Function Returns</h4>
7534
<h4 class="subsection">6.5.6 Continuing Until Function Returns</h4>
8767
7535
8768
<p>To continue running until the current function returns, use the
8769
<code>Finish</code> button. The returned value (if any) is printed.
7536
<p><a name="index-Execution_002c-until-function-returns-805"></a><a name="index-Continue_002c-until-function-returns-806"></a>
7537
<a name="index-Finish-807"></a>To continue running until the current function returns, use the
7538
‘<samp><span class="samp">Finish</span></samp>’ button. The returned value (if any) is printed.
8770
7539
8771
7540
<div class="node">
8772
7541
<p><hr>
8773
<small class=header>
8774
Node:<a name="Continuing%20Somewhere%20Else">Continuing Somewhere Else</a>,
8775
Next:<a rel="next" accesskey="n" href="#Stack">Stack</a>,
8776
Previous:<a rel="previous" accesskey="p" href="#Resuming%20Execution">Resuming Execution</a>,
8777
Up:<a rel="up" accesskey="u" href="#Running">Running</a>
7542
<a name="Continuing-Somewhere-Else"></a>
7543
Next: <a rel="next" accesskey="n" href="#Stack">Stack</a>,
7544
Previous: <a rel="previous" accesskey="p" href="#Resuming-Execution">Resuming Execution</a>,
7545
Up: <a rel="up" accesskey="u" href="#Running">Running</a>
8778
7546
</small>
8779
7547
8780
<br>
7548
8781
7549
</div>
8782
7550
8783
<h3 class="section">Continuing at a Different Address</h3>
7551
<h3 class="section">6.6 Continuing at a Different Address</h3>
8784
7552
8785
<p>Ordinarily, when you continue your program, you do so at the place where
7553
<p><a name="index-Execution_002c-at-different-address-808"></a><a name="index-Continue_002c-at-different-address-809"></a><a name="index-Jump-to-different-address-810"></a>
7554
Ordinarily, when you continue your program, you do so at the place where
8786
7555
it stopped. You can instead continue at an address of your own
8787
7556
choosing.
8788
7557
8789
<p>The most common occasion to use this feature is to back up--perhaps
7558
<p>The most common occasion to use this feature is to back up—perhaps
8790
7559
with more breakpoints set-over a portion of a program that has already
8791
7560
executed, in order to examine its execution in more detail.
8792
7561
8793
<p>To set the execution position to the current location, use <code>Set
8794
Execution Position</code> from the breakpoint popup menu. This item is also
8795
accessible by pressing and holding the <code>Break/Clear</code>
8796
button.<a rel="footnote" href="#fn-23"><sup>23</sup></a>
8797
8798
<p>As a quicker alternative, you can also press <em>mouse button 1</em> on
8799
the arrow and drag it to a different location.<a rel="footnote" href="#fn-24"><sup>24</sup></a>
8800
8801
<br><p>
7562
<p><a name="index-Set-Execution-Position-811"></a>To set the execution position to the current location, use ‘<samp><span class="samp">Set
7563
Execution Position</span></samp>’ from the breakpoint popup menu. This item is also
7564
accessible by pressing and holding the ‘<samp><span class="samp">Break/Clear</span></samp>’
7565
button.<a rel="footnote" href="#fn-23" name="fnd-23"><sup>23</sup></a>
7566
7567
<p><a name="index-Execution-position_002c-dragging-812"></a>As a quicker alternative, you can also press <em>mouse button 1</em> on
7568
the arrow and drag it to a different location.<a rel="footnote" href="#fn-24" name="fnd-24"><sup>24</sup></a>
7569
7570
<pre class="sp">
7571
7572
</pre>
8802
7573
<div align="center"><img src="PICS/ddd-drag.jpg" alt="PICS/ddd-drag.jpg"></div>
8803
<br><p>
8804
<p>Moving the execution position does not change the current stack frame,
7574
<pre class="sp">
7575
7576
</pre>
7577
7578
Moving the execution position does not change the current stack frame,
8805
7579
or the stack pointer, or the contents of any memory location or any
8806
7580
register other than the program counter.
8807
7581
8808
<p>Some inferior debuggers (notably <small>GDB</small>) allow you to set the new execution
7582
<p>Some inferior debuggers (notably <acronym>GDB</acronym>) allow you to set the new execution
8809
7583
position into a different function from the one currently executing.
8810
7584
This may lead to bizarre results if the two functions expect different
8811
7585
patterns of arguments or of local variables. For this reason, moving
8812
7586
the execution position requests confirmation if the specified line is
8813
7587
not in the function currently executing.
8814
7588
8815
<p>After moving the execution position, click on <code>Continue</code> to resume
7589
<p><a name="index-Continue-813"></a>After moving the execution position, click on ‘<samp><span class="samp">Continue</span></samp>’ to resume
8816
7590
execution.
8817
7591
8818
7592
<div class="node">
8819
7593
<p><hr>
8820
<small class=header>
8821
Node:<a name="Stack">Stack</a>,
8822
Next:<a rel="next" accesskey="n" href="#Undoing%20Program%20Execution">Undoing Program Execution</a>,
8823
Previous:<a rel="previous" accesskey="p" href="#Continuing%20Somewhere%20Else">Continuing Somewhere Else</a>,
8824
Up:<a rel="up" accesskey="u" href="#Running">Running</a>
7594
<a name="Stack"></a>
7595
Next: <a rel="next" accesskey="n" href="#Undoing-Program-Execution">Undoing Program Execution</a>,
7596
Previous: <a rel="previous" accesskey="p" href="#Continuing-Somewhere-Else">Continuing Somewhere Else</a>,
7597
Up: <a rel="up" accesskey="u" href="#Running">Running</a>
8825
7598
</small>
8826
7599
8827
<br>
7600
8828
7601
</div>
8829
7602
8830
<h3 class="section">Examining the Stack</h3>
7603
<h3 class="section">6.7 Examining the Stack</h3>
8831
7604
8832
<p>When your program has stopped, the first thing you need to know is
7605
<p>When your program has stopped, the first thing you need to know is
8833
7606
where it stopped and how it got there.
8834
7607
8835
<p>Each time your program performs a function call, information about the
7608
<p><a name="index-Frame-814"></a><a name="index-Stack-frame-815"></a><a name="index-Call-stack-816"></a>Each time your program performs a function call, information about the
8836
7609
call is generated. That information includes the location of the call
8837
7610
in your program, the arguments of the call, and the local variables of
8838
7611
the function being called. The information is saved in a block of data
8839
7612
called a <dfn>stack frame</dfn>. The stack frames are allocated in a region
8840
7613
of memory called the <dfn>call stack</dfn>.
8841
7614
8842
<p>When your program stops, the <small>DDD</small> commands for examining the
7615
<p>When your program stops, the <acronym>DDD</acronym> commands for examining the
8843
7616
stack allow you to see all of this information.
8844
7617
8845
<p>One of the stack frames is <dfn>selected</dfn> by <small>DDD</small> and many
8846
<small>DDD</small> commands refer implicitly to the selected frame. In
8847
particular, whenever you ask <small>DDD</small> for the value of a variable in
7618
<p>One of the stack frames is <dfn>selected</dfn> by <acronym>DDD</acronym> and many
7619
<acronym>DDD</acronym> commands refer implicitly to the selected frame. In
7620
particular, whenever you ask <acronym>DDD</acronym> for the value of a variable in
8848
7621
your program, the value is found in the selected frame. There are
8849
special <small>DDD</small> commands to select whichever frame you are
7622
special <acronym>DDD</acronym> commands to select whichever frame you are
8850
7623
interested in.
8851
7624
8852
7625
<ul class="menu">
8853
7626
<li><a accesskey="1" href="#Frames">Frames</a>: Callers and callees.
8854
7627
<li><a accesskey="2" href="#Backtraces">Backtraces</a>: And you may ask yourself, `how did I get here?'
8855
<li><a accesskey="3" href="#Selecting%20a%20frame">Selecting a frame</a>: Moving up and down.
7628
<li><a accesskey="3" href="#Selecting-a-frame">Selecting a frame</a>: Moving up and down.
8856
7629
</ul>
8857
7630
8858
7631
<div class="node">
8859
7632
<p><hr>
8860
<small class=header>
8861
Node:<a name="Frames">Frames</a>,
8862
Next:<a rel="next" accesskey="n" href="#Backtraces">Backtraces</a>,
8863
Up:<a rel="up" accesskey="u" href="#Stack">Stack</a>
7633
<a name="Frames"></a>
7634
Next: <a rel="next" accesskey="n" href="#Backtraces">Backtraces</a>,
7635
Up: <a rel="up" accesskey="u" href="#Stack">Stack</a>
8864
7636
</small>
8865
7637
8866
<br>
7638
8867
7639
</div>
8868
7640
8869
<h4 class="subsection">Stack Frames</h4>
7641
<h4 class="subsection">6.7.1 Stack Frames</h4>
8870
7642
8871
<p>The call stack is divided up into contiguous pieces called <dfn>stack
7643
<p><a name="index-Frame-817"></a><a name="index-Stack-Frame-818"></a>The call stack is divided up into contiguous pieces called <dfn>stack
8872
7644
frames</dfn>, or <dfn>frames</dfn> for short; each frame is the data associated
8873
7645
with one call to one function. The frame contains the arguments given
8874
7646
to the function, the function's local variables, and the address at
8875
7647
which the function is executing.
8876
7648
8877
<p>When your program is started, the stack has only one frame, that of the
7649
<p><a name="index-Initial-frame-819"></a><a name="index-Outermost-frame-820"></a><a name="index-Innermost-frame-821"></a>When your program is started, the stack has only one frame, that of the
8878
7650
function <code>main</code>. This is called the <dfn>initial</dfn> frame or the
8879
7651
<dfn>outermost</dfn> frame. Each time a function is called, a new frame is
8880
7652
made. Each time a function returns, the frame for that function invocation
8883
7655
actually occurring is called the <dfn>innermost</dfn> frame. This is the most
8884
7656
recently created of all the stack frames that still exist.
8885
7657
8886
<p>Inside your program, stack frames are identified by their addresses. A
7658
<p><a name="index-Frame-pointer-822"></a>Inside your program, stack frames are identified by their addresses. A
8887
7659
stack frame consists of many bytes, each of which has its own address; each
8888
7660
kind of computer has a convention for choosing one byte whose
8889
7661
address serves as the address of the frame. Usually this address is kept
8890
7662
in a register called the <dfn>frame pointer register</dfn> while execution is
8891
7663
going on in that frame.
8892
7664
8893
<p><small>GDB</small> assigns numbers to all existing stack frames, starting with zero for
7665
<p><a name="index-Frame-number-823"></a><acronym>GDB</acronym> assigns numbers to all existing stack frames, starting with zero for
8894
7666
the innermost frame, one for the frame that called it, and so on upward.
8895
7667
These numbers do not really exist in your program; they are assigned by
8896
<small>GDB</small> to give you a way of designating stack frames in <small>GDB</small> commands.
7668
<acronym>GDB</acronym> to give you a way of designating stack frames in <acronym>GDB</acronym> commands.
8897
7669
8898
7670
<div class="node">
8899
7671
<p><hr>
8900
<small class=header>
8901
Node:<a name="Backtraces">Backtraces</a>,
8902
Next:<a rel="next" accesskey="n" href="#Selecting%20a%20frame">Selecting a frame</a>,
8903
Previous:<a rel="previous" accesskey="p" href="#Frames">Frames</a>,
8904
Up:<a rel="up" accesskey="u" href="#Stack">Stack</a>
7672
<a name="Backtraces"></a>
7673
Next: <a rel="next" accesskey="n" href="#Selecting-a-frame">Selecting a frame</a>,
7674
Previous: <a rel="previous" accesskey="p" href="#Frames">Frames</a>,
7675
Up: <a rel="up" accesskey="u" href="#Stack">Stack</a>
8905
7676
</small>
8906
7677
8907
<br>
7678
8908
7679
</div>
8909
7680
8910
<h4 class="subsection">Backtraces</h4>
7681
<h4 class="subsection">6.7.2 Backtraces</h4>
8911
7682
8912
<p><small>DDD</small> provides a <dfn>backtrace window</dfn> showing a summary of how
7683
<p><acronym>DDD</acronym> provides a <dfn>backtrace window</dfn> showing a summary of how
8913
7684
your program got where it is. It shows one line per frame, for many
8914
7685
frames, starting with the currently executing frame (frame zero),
8915
7686
followed by its caller (frame one), and on up the stack.
8916
7687
8917
<p>To enable the backtrace window, select <code>Status =>
8918
Backtrace</code>.
8919
8920
<br><p>
7688
<p>To enable the backtrace window, select ‘<samp><span class="samp">Status
7689
Backtrace</span></samp>’.
7690
7691
<pre class="sp">
7692
7693
</pre>
8921
7694
<div align="center"><img src="PICS/ddd-backtrace.jpg" alt="PICS/ddd-backtrace.jpg"></div>
8922
<br><p>
8923
<p>Using <small>GDB</small>, each line in the backtrace shows the frame number and the
8924
function name. The program counter value is also shown--unless you use
8925
the <small>GDB</small> command <code>set print address off</code>. The backtrace also shows
7695
<pre class="sp">
7696
7697
</pre>
7698
7699
Using <acronym>GDB</acronym>, each line in the backtrace shows the frame number and the
7700
function name. The program counter value is also shown—unless you use
7701
the <acronym>GDB</acronym> command ‘<samp><span class="samp">set print address off</span></samp>’. The backtrace also shows
8926
7702
the source file name and line number, as well as the arguments to the
8927
7703
function. The program counter value is omitted if it is at the
8928
7704
beginning of the code for that line number.
8929
7705
8930
7706
<div class="node">
8931
7707
<p><hr>
8932
<small class=header>
8933
Node:<a name="Selecting%20a%20frame">Selecting a frame</a>,
8934
Previous:<a rel="previous" accesskey="p" href="#Backtraces">Backtraces</a>,
8935
Up:<a rel="up" accesskey="u" href="#Stack">Stack</a>
7708
<a name="Selecting-a-frame"></a>
7709
Previous: <a rel="previous" accesskey="p" href="#Backtraces">Backtraces</a>,
7710
Up: <a rel="up" accesskey="u" href="#Stack">Stack</a>
8936
7711
</small>
8937
7712
8938
<br>
7713
8939
7714
</div>
8940
7715
8941
<h4 class="subsection">Selecting a Frame</h4>
7716
<h4 class="subsection">6.7.3 Selecting a Frame</h4>
8942
7717
8943
<p>Most commands for examining the stack and other data in your program
7718
<p><a name="index-Frame_002c-selecting-824"></a><a name="index-Selecting-frames-825"></a><a name="index-Stack_002c-moving-within-826"></a>
7719
Most commands for examining the stack and other data in your program
8944
7720
work on whichever stack frame is selected at the moment. Here are the
8945
commands for selecting a stack frame.<a rel="footnote" href="#fn-25"><sup>25</sup></a>
7721
commands for selecting a stack frame.<a rel="footnote" href="#fn-25" name="fnd-25"><sup>25</sup></a>
8946
7722
8947
7723
<p>In the backtrace window, you can <em>select</em> an arbitrary frame to
8948
7724
move from one stack frame to another. Just click on the desired frame.
8949
7725
8950
<p>The <code>Up</code> button selects the function that called the current
8951
one--that is, it moves one frame up.
8952
8953
<p>The <code>Down</code> button selects the function that was called by
8954
the current one--that is, it moves one frame down.
8955
8956
<p>You can also directly type the <code>up</code> and <code>down</code> commands at
7726
<p><a name="index-Up-827"></a>The ‘<samp><span class="samp">Up</span></samp>’ button selects the function that called the current
7727
one—that is, it moves one frame up.
7728
7729
<p><a name="index-Down-828"></a>The ‘<samp><span class="samp">Down</span></samp>’ button selects the function that was called by
7730
the current one—that is, it moves one frame down.
7731
7732
<p><a name="index-up-829"></a><a name="index-down-830"></a><a name="index-Ctrl_002bUp-831"></a><a name="index-Ctrl_002bDown-832"></a>You can also directly type the <samp><span class="command">up</span></samp> and <samp><span class="command">down</span></samp> commands at
8957
7733
the debugger prompt. Typing <Ctrl+Up> and <Ctrl+Down>,
8958
7734
respectively, will also move you through the stack.
8959
7735
8960
<p><code>Up</code> and <code>Down</code> actions can be undone via <code>Edit =>
8961
Undo</code>.
7736
<p>‘<samp><span class="samp">Up</span></samp>’ and ‘<samp><span class="samp">Down</span></samp>’ actions can be undone via ‘<samp><span class="samp">Edit
7737
Undo</span></samp>’.
7738
<a name="index-Undo-833"></a><a name="index-Undoing-frame-changes-834"></a><a name="index-Frame-changes_002c-undoing-835"></a>
8962
7739
8963
7740
<div class="node">
8964
7741
<p><hr>
8965
<small class=header>
8966
Node:<a name="Undoing%20Program%20Execution">Undoing Program Execution</a>,
8967
Next:<a rel="next" accesskey="n" href="#Threads">Threads</a>,
8968
Previous:<a rel="previous" accesskey="p" href="#Stack">Stack</a>,
8969
Up:<a rel="up" accesskey="u" href="#Running">Running</a>
7742
<a name="Undoing-Program-Execution"></a>
7743
Next: <a rel="next" accesskey="n" href="#Threads">Threads</a>,
7744
Previous: <a rel="previous" accesskey="p" href="#Stack">Stack</a>,
7745
Up: <a rel="up" accesskey="u" href="#Running">Running</a>
8970
7746
</small>
8971
7747
8972
<br>
7748
8973
7749
</div>
8974
7750
8975
<h3 class="section">"Undoing" Program Execution</h3>
7751
<h3 class="section">6.8 “Undoing” Program Execution</h3>
8976
7752
8977
<p>If you take a look at the <code>Edit => Undo</code> menu item after an
8978
execution command, you'll find that <small>DDD</small> offers you to undo
7753
<p><a name="index-Execution_002c-_0060_0060undoing_0027_0027-836"></a><a name="index-Undoing-program-execution-837"></a>
7754
If you take a look at the ‘<samp><span class="samp">Edit Undo</span></samp>’ menu item after an
7755
execution command, you'll find that <acronym>DDD</acronym> offers you to undo
8979
7756
execution commands just as other commands. Does this mean that
8980
<small>DDD</small> allows you to go backwards in time, undoing program
7757
<acronym>DDD</acronym> allows you to go backwards in time, undoing program
8981
7758
execution as well as undoing any side-effects of your program?
8982
7759
8983
<p>Sorry--we must disappoint you. <small>DDD</small> cannot undo what your
7760
<p>Sorry—we must disappoint you. <acronym>DDD</acronym> cannot undo what your
8984
7761
program did. (After a little bit of thought, you'll find that this
8985
would be impossible in general.) However, <small>DDD</small> can do something
7762
would be impossible in general.) However, <acronym>DDD</acronym> can do something
8986
7763
different: it can show <em>previously recorded states</em> of your
8987
7764
program.
8988
7765
8989
<p>After "undoing" an execution command (via
8990
<code>Edit => Undo</code>, or the <code>Undo</code> button), the execution
7766
<p>After “undoing” an execution command (via
7767
‘<samp><span class="samp">Edit Undo</span></samp>’, or the ‘<samp><span class="samp">Undo</span></samp>’ button), the execution
8991
7768
position moves back to the earlier position and displayed variables
8992
7769
take their earlier values. Your program state is in fact unchanged,
8993
but <small>DDD</small> gives you a <em>view</em> on the earlier state as recorded by
8994
<small>DDD</small>.
7770
but <acronym>DDD</acronym> gives you a <em>view</em> on the earlier state as recorded by
7771
<acronym>DDD</acronym>.
8995
7772
8996
<p>In this so-called <dfn>historic mode</dfn>, most normal <small>DDD</small>
7773
<p><a name="index-Historic-mode-838"></a><a name="index-Undo-839"></a><a name="index-Redo-840"></a>In this so-called <dfn>historic mode</dfn>, most normal <acronym>DDD</acronym>
8997
7774
commands that would query further information from the program are
8998
7775
disabled, since the debugger cannot be queried for the earlier state.
8999
7776
However, you can examine the current execution position, or the
9000
displayed variables. Using <code>Undo</code> and <code>Redo</code>, you can
7777
displayed variables. Using ‘<samp><span class="samp">Undo</span></samp>’ and ‘<samp><span class="samp">Redo</span></samp>’, you can
9001
7778
move back and forward in time to examine how your program got into the
9002
7779
present state.
9003
7780
9007
7784
status line informs you that you are seeing an earlier program state.
9008
7785
9009
7786
<p>Here's how historic mode works: each time your program stops,
9010
<small>DDD</small> collects the current execution position and the values of
7787
<acronym>DDD</acronym> collects the current execution position and the values of
9011
7788
displayed variables. Backtrace, thread, and register information is
9012
7789
also collected if the corresponding dialogs are open. When
9013
"undoing" an execution command, <small>DDD</small> updates its view
7790
“undoing” an execution command, <acronym>DDD</acronym> updates its view
9014
7791
from this collected state instead of querying the program.
9015
7792
9016
<p>If you want to collect this information without interrupting your
9017
program--within a loop, for instance--you can place a breakpoint with
9018
an associated <code>cont</code> command (see <a href="#Breakpoint%20Commands">Breakpoint Commands</a>).
9019
When the breakpoint is hit, <small>DDD</small> will stop, collect the data, and
9020
execute the <code>cont</code> command, resuming execution. Using a later
9021
<code>Undo</code>, you can step back and look at every single loop iteration.
7793
<p><a name="index-cont-841"></a>If you want to collect this information without interrupting your
7794
program—within a loop, for instance—you can place a breakpoint with
7795
an associated <samp><span class="command">cont</span></samp> command (see <a href="#Breakpoint-Commands">Breakpoint Commands</a>).
7796
When the breakpoint is hit, <acronym>DDD</acronym> will stop, collect the data, and
7797
execute the ‘<samp><span class="samp">cont</span></samp>’ command, resuming execution. Using a later
7798
‘<samp><span class="samp">Undo</span></samp>’, you can step back and look at every single loop iteration.
9022
7799
9023
<p>To leave historic mode, you can use <code>Redo</code> until you are back in
9024
the current program state. However, any <small>DDD</small> command that
7800
<p>To leave historic mode, you can use ‘<samp><span class="samp">Redo</span></samp>’ until you are back in
7801
the current program state. However, any <acronym>DDD</acronym> command that
9025
7802
refers to program state will also leave historic mode immediately by
9026
7803
applying to the current program state instead. For instance,
9027
<code>Up</code> leaves historic mode immediately and selects an alternate
7804
‘<samp><span class="samp">Up</span></samp>’ leaves historic mode immediately and selects an alternate
9028
7805
frame in the restored current program state.
9029
7806
9030
7807
<p>If you want to see the history of a specific variable, as recorded
9031
during program stops, you can enter the <small>DDD</small> command
7808
during program stops, you can enter the <acronym>DDD</acronym> command
9032
7809
9033
7810
<pre class="example"> graph history <var>name</var>
9034
</pre>
9035
7811
</pre>
9036
7812
<p>This returns a list of all previously recorded values of the variable
9037
7813
<var>name</var>, using array syntax. Note that <var>name</var> must have been
9038
7814
displayed at earlier program stops in order to record values.
9039
7815
9040
7816
<div class="node">
9041
7817
<p><hr>
9042
<small class=header>
9043
Node:<a name="Threads">Threads</a>,
9044
Next:<a rel="next" accesskey="n" href="#Signals">Signals</a>,
9045
Previous:<a rel="previous" accesskey="p" href="#Undoing%20Program%20Execution">Undoing Program Execution</a>,
9046
Up:<a rel="up" accesskey="u" href="#Running">Running</a>
7818
<a name="Threads"></a>
7819
Next: <a rel="next" accesskey="n" href="#Signals">Signals</a>,
7820
Previous: <a rel="previous" accesskey="p" href="#Undoing-Program-Execution">Undoing Program Execution</a>,
7821
Up: <a rel="up" accesskey="u" href="#Running">Running</a>
9047
7822
</small>
9048
7823
9049
<br>
7824
9050
7825
</div>
9051
7826
9052
<h3 class="section">Examining Threads</h3>
7827
<h3 class="section">6.9 Examining Threads</h3>
9053
7828
9054
<p>In some operating systems, a single program may have more than one
7829
<p><a name="index-Threads-842"></a>
7830
In some operating systems, a single program may have more than one
9055
7831
<em>thread</em> of execution. The precise semantics of threads differ
9056
7832
from one operating system to another, but in general the threads of a
9057
single program are akin to multiple processes--except that they share
7833
single program are akin to multiple processes—except that they share
9058
7834
one address space (that is, they can all examine and modify the same
9059
7835
variables). On the other hand, each thread has its own registers and
9060
7836
execution stack, and perhaps private memory.
9061
7837
9062
<p>For debugging purposes, <small>DDD</small> lets you display the list of threads
7838
<p>For debugging purposes, <acronym>DDD</acronym> lets you display the list of threads
9063
7839
currently active in your program and lets you select the <em>current
9064
thread</em>--the thread which is the focus of debugging. <small>DDD</small> shows
7840
thread</em>—the thread which is the focus of debugging. <acronym>DDD</acronym> shows
9065
7841
all program information from the perspective of the current
9066
thread.<a rel="footnote" href="#fn-26"><sup>26</sup></a>
9067
9068
<br><p>
7842
thread.<a rel="footnote" href="#fn-26" name="fnd-26"><sup>26</sup></a>
7843
7844
<pre class="sp">
7845
7846
</pre>
9069
7847
<div align="center"><img src="PICS/ddd-threads.jpg" alt="PICS/ddd-threads.jpg"></div>
9070
<br><p>
9071
<p>To view all currently active threads in your program, select
9072
<code>Status => Threads</code>. The current thread is highlighted.
7848
<pre class="sp">
7849
7850
</pre>
7851
7852
<a name="index-Threads-843"></a>To view all currently active threads in your program, select
7853
‘<samp><span class="samp">Status Threads</span></samp>’. The current thread is highlighted.
9073
7854
Select any thread to make it the current thread.
9074
7855
9075
<p>Using <small>JDB</small>, additional functionality is available:
7856
<p>Using <acronym>JDB</acronym>, additional functionality is available:
9076
7857
9077
7858
<ul>
9078
7859
<li>Select a <em>thread group</em> to switch between viewing all threads and
9079
7860
the threads of the selected thread group;
9080
<li>Click on <code>Suspend</code> to suspend execution of the selected threads;
9081
<li>Click on <code>Resume</code> to resume execution of the selected threads.
7861
<li>Click on ‘<samp><span class="samp">Suspend</span></samp>’ to suspend execution of the selected threads;
7862
<li>Click on ‘<samp><span class="samp">Resume</span></samp>’ to resume execution of the selected threads.
9082
7863
</ul>
9083
7864
9084
<p>For more information on threads, see the <small>JDB</small> and <small>GDB</small> documentation
7865
<p>For more information on threads, see the <acronym>JDB</acronym> and <acronym>GDB</acronym> documentation
9085
7866
(see <a href="gdb.html#Threads">Debugging programs with multiple threads</a>).
9086
7867
9087
7868
<div class="node">
9088
7869
<p><hr>
9089
<small class=header>
9090
Node:<a name="Signals">Signals</a>,
9091
Next:<a rel="next" accesskey="n" href="#Killing%20the%20Program">Killing the Program</a>,
9092
Previous:<a rel="previous" accesskey="p" href="#Threads">Threads</a>,
9093
Up:<a rel="up" accesskey="u" href="#Running">Running</a>
7870
<a name="Signals"></a>
7871
Next: <a rel="next" accesskey="n" href="#Killing-the-Program">Killing the Program</a>,
7872
Previous: <a rel="previous" accesskey="p" href="#Threads">Threads</a>,
7873
Up: <a rel="up" accesskey="u" href="#Running">Running</a>
9094
7874
</small>
9095
7875
9096
<br>
7876
9097
7877
</div>
9098
7878
9099
<h3 class="section">Handling Signals</h3>
7879
<h3 class="section">6.10 Handling Signals</h3>
9100
7880
9101
<p>A signal is an asynchronous event that can happen in a program. The
7881
<p><a name="index-Signals-844"></a><a name="index-SIGINT-signal-845"></a><a name="index-SIGSEGV-signal-846"></a><a name="index-SIGALRM-signal-847"></a>
7882
A signal is an asynchronous event that can happen in a program. The
9102
7883
operating system defines the possible kinds of signals, and gives each
9103
kind a name and a number. For example, in <small>UNIX</small>, <code>SIGINT</code> is the
7884
kind a name and a number. For example, in <acronym>UNIX</acronym>, <code>SIGINT</code> is the
9104
7885
signal a program gets when you type an interrupt; <code>SIGSEGV</code> is
9105
7886
the signal a program gets from referencing a place in memory far away
9106
7887
from all the areas in use; <code>SIGALRM</code> occurs when the alarm clock
9107
7888
timer goes off (which happens only if your program has requested an
9108
7889
alarm).
9109
7890
9110
<p>Some signals, including <code>SIGALRM</code>, are a normal part of the
7891
<p><a name="index-Signal_002c-fatal-848"></a>Some signals, including <code>SIGALRM</code>, are a normal part of the
9111
7892
functioning of your program. Others, such as <code>SIGSEGV</code>, indicate
9112
7893
errors; these signals are <em>fatal</em> (kill your program immediately)
9113
7894
if the program has not specified in advance some other way to handle the
9115
7896
it is normally fatal so it can carry out the purpose of the interrupt:
9116
7897
to kill the program.
9117
7898
9118
<p><small>GDB</small> has the ability to detect any occurrence of a signal in your
9119
program. You can tell <small>GDB</small> in advance what to do for each kind of
7899
<p><acronym>GDB</acronym> has the ability to detect any occurrence of a signal in your
7900
program. You can tell <acronym>GDB</acronym> in advance what to do for each kind of
9120
7901
signal.
9121
7902
9122
<p>Normally, <small>DDD</small> is set up to ignore non-erroneous signals like
7903
<p><a name="index-Signal-settings_002c-editing-849"></a><a name="index-Signals-850"></a>Normally, <acronym>DDD</acronym> is set up to ignore non-erroneous signals like
9123
7904
<code>SIGALRM</code> (so as not to interfere with their role in the
9124
7905
functioning of your program) but to stop your program immediately
9125
whenever an error signal happens. In <small>DDD</small>, you can view and edit
9126
these settings via <code>Status => Signals</code>.
7906
whenever an error signal happens. In <acronym>DDD</acronym>, you can view and edit
7907
these settings via ‘<samp><span class="samp">Status Signals</span></samp>’.
9127
7908
9128
<p><code>Status => Signals</code> pops up a panel showing all the kinds of
9129
signals and how <small>GDB</small> has been told to handle each one. The settings
7909
<p>‘<samp><span class="samp">Status Signals</span></samp>’ pops up a panel showing all the kinds of
7910
signals and how <acronym>GDB</acronym> has been told to handle each one. The settings
9130
7911
available for each signal are:
9131
7912
9132
7913
<dl>
9133
<dt><code>Stop</code>
9134
<dd>If set, <small>GDB</small> should stop your program when this signal happens.
9135
This also implies <code>Print</code> being set.
9136
9137
<br><dt><code>Print</code>
9138
<dd>If set, <small>GDB</small> should print a message when this signal happens.
9139
9140
<p>If unset, <small>GDB</small> should not mention the occurrence of the signal at all.
9141
This also implies <code>Stop</code> being unset.
9142
9143
<br><dt><code>Pass</code>
9144
<dd>If set, <small>GDB</small> should allow your program to see this signal; your
7914
<dt><code>Stop</code><dd><a name="index-Stop-851"></a>If set, <acronym>GDB</acronym> should stop your program when this signal happens.
7915
This also implies ‘<samp><span class="samp">Print</span></samp>’ being set.
7916
7917
<br><dt><code>Print</code><dd><a name="index-Print-852"></a>If set, <acronym>GDB</acronym> should print a message when this signal happens.
7918
7919
<p>If unset, <acronym>GDB</acronym> should not mention the occurrence of the signal at all.
7920
This also implies ‘<samp><span class="samp">Stop</span></samp>’ being unset.
7921
7922
<br><dt><code>Pass</code><dd><a name="index-Pass-853"></a>If set, <acronym>GDB</acronym> should allow your program to see this signal; your
9145
7923
program can handle the signal, or else it may terminate if the signal
9146
7924
is fatal and not handled.
9147
7925
9148
<p>If unset, <small>GDB</small> should not allow your program to see this signal.
7926
<p>If unset, <acronym>GDB</acronym> should not allow your program to see this signal.
9149
7927
</dl>
9150
7928
9151
<br><p>
7929
<pre class="sp">
7930
7931
</pre>
9152
7932
<div align="center"><img src="PICS/ddd-signals.jpg" alt="PICS/ddd-signals.jpg"></div>
9153
<br><p>
9154
<p>The entry <code>All Signals</code> is special. Changing a setting here
9155
affects <em>all signals at once</em>--except those used by the debugger,
7933
<pre class="sp">
7934
7935
</pre>
7936
7937
<a name="index-All-Signals-854"></a><a name="index-SIGTRAP-signal-855"></a>The entry ‘<samp><span class="samp">All Signals</span></samp>’ is special. Changing a setting here
7938
affects <em>all signals at once</em>—except those used by the debugger,
9156
7939
typically <code>SIGTRAP</code> and <code>SIGINT</code>.
9157
7940
9158
<p>To undo any changes, use <code>Edit => Undo</code>. The <code>Reset</code>
7941
<p><a name="index-Reset-856"></a><a name="index-Undoing-signal-handling-857"></a>To undo any changes, use ‘<samp><span class="samp">Edit Undo</span></samp>’. The ‘<samp><span class="samp">Reset</span></samp>’
9159
7942
button restores the saved settings.
9160
7943
9161
7944
<p>When a signal stops your program, the signal is not visible until you
9162
continue. Your program sees the signal then, if <code>Pass</code> is in
7945
continue. Your program sees the signal then, if ‘<samp><span class="samp">Pass</span></samp>’ is in
9163
7946
effect for the signal in question <em>at that time</em>. In other words,
9164
after <small>GDB</small> reports a signal, you can change the <code>Pass</code> setting in
9165
<code>Status => Signals</code> to control whether your program sees
7947
after <acronym>GDB</acronym> reports a signal, you can change the ‘<samp><span class="samp">Pass</span></samp>’ setting in
7948
‘<samp><span class="samp">Status Signals</span></samp>’ to control whether your program sees
9166
7949
that signal when you continue.
9167
7950
9168
<p>You can also cause your program to see a signal it normally would not
9169
see, or to give it any signal at any time. The <code>Send</code> button will
7951
<p><a name="index-Send-858"></a>You can also cause your program to see a signal it normally would not
7952
see, or to give it any signal at any time. The ‘<samp><span class="samp">Send</span></samp>’ button will
9170
7953
resume execution where your program stopped, but immediately give it the
9171
7954
signal shown.
9172
7955
9173
<p>On the other hand, you can also prevent your program from seeing a
7956
<p><a name="index-Continue-Without-Signal-859"></a>On the other hand, you can also prevent your program from seeing a
9174
7957
signal. For example, if your program stopped due to some sort of memory
9175
7958
reference error, you might store correct values into the erroneous
9176
7959
variables and continue, hoping to see more execution; but your program
9177
7960
would probably terminate immediately as a result of the fatal signal
9178
7961
once it saw the signal. To prevent this, you can resume execution using
9179
<code>Commands => Continue Without Signal</code>.
7962
‘<samp><span class="samp">Commands Continue Without Signal</span></samp>’.
9180
7963
9181
<p>Signal settings are not saved across DDD invocations, since changed
7964
<p><a name="index-Save-Options-860"></a><a name="index-Save-Session-As-861"></a><a name="index-Signal-settings_002c-saving-862"></a>Signal settings are not saved across DDD invocations, since changed
9182
7965
signal settings are normally useful within specific projects only.
9183
7966
Instead, signal settings are saved with the current session, using
9184
<code>File => Save Session As</code>.
7967
‘<samp><span class="samp">File Save Session As</span></samp>’.
9185
7968
9186
7969
<div class="node">
9187
7970
<p><hr>
9188
<small class=header>
9189
Node:<a name="Killing%20the%20Program">Killing the Program</a>,
9190
Previous:<a rel="previous" accesskey="p" href="#Signals">Signals</a>,
9191
Up:<a rel="up" accesskey="u" href="#Running">Running</a>
7971
<a name="Killing-the-Program"></a>
7972
Previous: <a rel="previous" accesskey="p" href="#Signals">Signals</a>,
7973
Up: <a rel="up" accesskey="u" href="#Running">Running</a>
9192
7974
</small>
9193
7975
9194
<br>
7976
9195
7977
</div>
9196
7978
9197
<h3 class="section">Killing the Program</h3>
9198
9199
<p>You can kill the process of the debugged program at any time using the
9200
<code>Kill</code> button.
9201
9202
<p>Killing the process is useful if you wish to debug a core dump instead
9203
of a running process. <small>GDB</small> ignores any core dump file while your program
7979
<h3 class="section">6.11 Killing the Program</h3>
7980
7981
<p><a name="index-Killing-the-debugged-program-863"></a>
7982
You can kill the process of the debugged program at any time using the
7983
‘<samp><span class="samp">Kill</span></samp>’ button.
7984
<a name="index-Kill-864"></a>
7985
Killing the process is useful if you wish to debug a core dump instead
7986
of a running process. <acronym>GDB</acronym> ignores any core dump file while your program
9204
7987
is running.
9205
7988
9206
<p>The <code>Kill</code> button is also useful if you wish to recompile and
7989
<p>The ‘<samp><span class="samp">Kill</span></samp>’ button is also useful if you wish to recompile and
9207
7990
relink your program, since on many systems it is impossible to modify an
9208
7991
executable file while it is running in a process. In this case, when
9209
you next click on <code>Run</code>, <small>GDB</small> notices that the file has changed, and
7992
you next click on ‘<samp><span class="samp">Run</span></samp>’, <acronym>GDB</acronym> notices that the file has changed, and
9210
7993
reads the symbol table again (while trying to preserve your current
9211
7994
debugger state).
9212
7995
9213
7996
<div class="node">
9214
7997
<p><hr>
9215
<small class=header>
9216
Node:<a name="Examining%20Data">Examining Data</a>,
9217
Next:<a rel="next" accesskey="n" href="#Machine-Level%20Debugging">Machine-Level Debugging</a>,
9218
Previous:<a rel="previous" accesskey="p" href="#Running">Running</a>,
9219
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
7998
<a name="Examining-Data"></a>
7999
Next: <a rel="next" accesskey="n" href="#Machine_002dLevel-Debugging">Machine-Level Debugging</a>,
8000
Previous: <a rel="previous" accesskey="p" href="#Running">Running</a>,
8001
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
9220
8002
</small>
9221
8003
9222
<br>
8004
9223
8005
</div>
9224
8006
9225
<h2 class="chapter">Examining Data</h2>
8007
<h2 class="chapter">7 Examining Data</h2>
9226
8008
9227
<p><small>DDD</small> provides several means to examine data.
8009
<p><acronym>DDD</acronym> provides several means to examine data.
9228
8010
9229
8011
<ul>
9230
<li>The quickest way to examine variables is to move the pointer on an
8012
<li><a name="index-Value-tip-865"></a><a name="index-Tip_002c-value-866"></a>The quickest way to examine variables is to move the pointer on an
9231
8013
occurrence in the source text. The value is displayed in the source
9232
8014
line; after a second, a popup window (called <dfn>value tip</dfn>) shows the
9233
8015
variable value. This is useful for quick examination of several simple
9234
8016
values.
9235
8017
9236
<li>If you want to refer to variable values at a later time, you can
8018
<li><a name="index-Printing-values-867"></a><a name="index-Value_002c-printing-868"></a>If you want to refer to variable values at a later time, you can
9237
8019
<dfn>print</dfn> the value in the debugger console. This allows for
9238
8020
displaying and examining larger data structures.
9239
8021
9240
<li>If you want to examine complex data structures, you can <dfn>display</dfn>
8022
<li><a name="index-Displaying-values-869"></a><a name="index-Value_002c-displaying-870"></a>If you want to examine complex data structures, you can <dfn>display</dfn>
9241
8023
them graphically in the data window. Displays remain effective until
9242
8024
you delete them; they are updated each time the program stops. This is
9243
8025
useful for large dynamic structures.
9244
8026
9245
<li>If you want to examine arrays of numeric values, you can <dfn>plot</dfn> them
8027
<li><a name="index-Plotting-values-871"></a><a name="index-Value_002c-plotting-872"></a>If you want to examine arrays of numeric values, you can <dfn>plot</dfn> them
9246
8028
graphically in a separate plot window. The plot is updated each time
9247
8029
the program stops. This is useful for large numeric arrays.
9248
8030
9249
<li>Using <small>GDB</small> or <small>DBX</small>, you can also <dfn>examine memory contents</dfn> in any of
8031
<li>Using <acronym>GDB</acronym> or <acronym>DBX</acronym>, you can also <dfn>examine memory contents</dfn> in any of
9250
8032
several formats, independently of your program's data types.
9251
</ul>
8033
<a name="index-Dumping-values-873"></a><a name="index-Value_002c-dumping-874"></a><a name="index-Memory_002c-dumping-contents-875"></a></ul>
9252
8034
9253
8035
<ul class="menu">
9254
<li><a accesskey="1" href="#Value%20Tips">Value Tips</a>: Just move the pointer on a variable.
9255
<li><a accesskey="2" href="#Printing%20Values">Printing Values</a>: Printing a value in the debugger console.
9256
<li><a accesskey="3" href="#Displaying%20Values">Displaying Values</a>: Displaying structures as graphs.
9257
<li><a accesskey="4" href="#Plotting%20Values">Plotting Values</a>: Displaying values as plots.
9258
<li><a accesskey="5" href="#Examining%20Memory">Examining Memory</a>: Low-level memory examination.
8036
<li><a accesskey="1" href="#Value-Tips">Value Tips</a>: Just move the pointer on a variable.
8037
<li><a accesskey="2" href="#Printing-Values">Printing Values</a>: Printing a value in the debugger console.
8038
<li><a accesskey="3" href="#Displaying-Values">Displaying Values</a>: Displaying structures as graphs.
8039
<li><a accesskey="4" href="#Plotting-Values">Plotting Values</a>: Displaying values as plots.
8040
<li><a accesskey="5" href="#Examining-Memory">Examining Memory</a>: Low-level memory examination.
9259
8041
</ul>
9260
8042
9261
8043
<div class="node">
9262
8044
<p><hr>
9263
<small class=header>
9264
Node:<a name="Value%20Tips">Value Tips</a>,
9265
Next:<a rel="next" accesskey="n" href="#Printing%20Values">Printing Values</a>,
9266
Up:<a rel="up" accesskey="u" href="#Examining%20Data">Examining Data</a>
8045
<a name="Value-Tips"></a>
8046
Next: <a rel="next" accesskey="n" href="#Printing-Values">Printing Values</a>,
8047
Up: <a rel="up" accesskey="u" href="#Examining-Data">Examining Data</a>
9267
8048
</small>
9268
8049
9269
<br>
8050
9270
8051
</div>
9271
8052
9272
<h3 class="section">Showing Simple Values using Value Tips</h3>
8053
<h3 class="section">7.1 Showing Simple Values using Value Tips</h3>
9273
8054
9274
<p>To display the value of a simple variable, move the mouse pointer on its
8055
<p><a name="index-Value-tip-876"></a><a name="index-Tip_002c-value-877"></a>
8056
To display the value of a simple variable, move the mouse pointer on its
9275
8057
name. After a second, a small window (called <dfn>value tip</dfn>) pops up
9276
8058
showing the value of the variable pointed at. The window disappears as
9277
8059
soon as you move the mouse pointer away from the variable. The value is
9278
8060
also shown in the status line.
9279
8061
9280
<br><p>
8062
<pre class="sp">
8063
8064
</pre>
9281
8065
<div align="center"><img src="PICS/ddd-value-tip.jpg" alt="PICS/ddd-value-tip.jpg"></div>
9282
<br><p>
9283
<p>You can disable value tips via <code>Edit => Preferences
9284
=> General => Automatic display of variable values as
9285
popup tips</code>.
8066
<pre class="sp">
8067
8068
</pre>
8069
8070
You can disable value tips via ‘<samp><span class="samp">Edit Preferences
8071
General Automatic display of variable values as
8072
popup tips</span></samp>’.
9286
8073
9287
8074
<p>You can disable displaying variable values in the status line via
9288
<code>Edit => Preferences => General => Automatic
9289
display of variable values in the status line</code>.
8075
‘<samp><span class="samp">Edit Preferences General Automatic
8076
display of variable values in the status line</span></samp>’.
9290
8077
9291
8078
<p>These customizations are tied to the following resources:
9292
8079
9293
<p>
9294
<table width="100%">
9295
<tr>
9296
<td align="left"><b>valueTips</b><i> </i>(<i>class Tips</i>)<i>
9297
</i></td>
9298
<td align="right">Resource</td>
9299
</tr>
9300
</table>
9301
<table width="95%" align="center">
9302
<tr><td>
9303
Whether value tips are enabled (<code>on</code>, default) or not
9304
(<code>off</code>). Value tips affect <small>DDD</small> performance and may
8080
<div class="defun">
8081
— Resource: <b>valueTips</b> (<var>class Tips</var>)<var><a name="index-valueTips-878"></a></var><br>
8082
<blockquote><p>Whether value tips are enabled (‘<samp><span class="samp">on</span></samp>’, default) or not
8083
(‘<samp><span class="samp">off</span></samp>’). Value tips affect <acronym>DDD</acronym> performance and may
9305
8084
be distracting for some experienced users.
9306
</td></tr>
9307
</table>
9308
9309
<p>
9310
<table width="100%">
9311
<tr>
9312
<td align="left"><b>valueDocs</b><i> </i>(<i>class Docs</i>)<i>
9313
</i></td>
9314
<td align="right">Resource</td>
9315
</tr>
9316
</table>
9317
<table width="95%" align="center">
9318
<tr><td>
9319
Whether the display of variable values in the status line is enabled
9320
(<code>on</code>, default) or not (<code>off</code>).
9321
</td></tr>
9322
</table>
9323
9324
<p>You can turn off value tips via <code>Edit => Preferences
9325
=> General => Automatic Display of Variable Values</code>.
8085
</p></blockquote></div>
8086
8087
<div class="defun">
8088
— Resource: <b>valueDocs</b> (<var>class Docs</var>)<var><a name="index-valueDocs-879"></a></var><br>
8089
<blockquote><p>Whether the display of variable values in the status line is enabled
8090
(‘<samp><span class="samp">on</span></samp>’, default) or not (‘<samp><span class="samp">off</span></samp>’).
8091
</p></blockquote></div>
8092
8093
<p><a name="index-Automatic-Display-of-Variable-Values-880"></a>You can turn off value tips via ‘<samp><span class="samp">Edit Preferences
8094
General Automatic Display of Variable Values</span></samp>’.
9326
8095
9327
8096
<div class="node">
9328
8097
<p><hr>
9329
<small class=header>
9330
Node:<a name="Printing%20Values">Printing Values</a>,
9331
Next:<a rel="next" accesskey="n" href="#Displaying%20Values">Displaying Values</a>,
9332
Previous:<a rel="previous" accesskey="p" href="#Value%20Tips">Value Tips</a>,
9333
Up:<a rel="up" accesskey="u" href="#Examining%20Data">Examining Data</a>
8098
<a name="Printing-Values"></a>
8099
Next: <a rel="next" accesskey="n" href="#Displaying-Values">Displaying Values</a>,
8100
Previous: <a rel="previous" accesskey="p" href="#Value-Tips">Value Tips</a>,
8101
Up: <a rel="up" accesskey="u" href="#Examining-Data">Examining Data</a>
9334
8102
</small>
9335
8103
9336
<br>
8104
9337
8105
</div>
9338
8106
9339
<h3 class="section">Printing Simple Values in the Debugger Console</h3>
8107
<h3 class="section">7.2 Printing Simple Values in the Debugger Console</h3>
9340
8108
9341
<p>The variable value can also be printed in the debugger console, making
8109
<p><a name="index-Printing-values-881"></a><a name="index-Value_002c-printing-882"></a><a name="index-Print-883"></a>
8110
The variable value can also be printed in the debugger console, making
9342
8111
it available for future operations. To print a variable value, select
9343
8112
the desired variable by clicking <em>mouse button 1</em> on its name. The
9344
8113
variable name is copied to the argument field. By clicking the
9345
<code>Print</code> button, the value is printed in the debugger console. The
8114
‘<samp><span class="samp">Print</span></samp>’ button, the value is printed in the debugger console. The
9346
8115
printed value is also shown in the status line.
9347
8116
9348
8117
<p>As a shorter alternative, you can simply press <em>mouse button 3</em> on
9349
the variable name and select the <code>Print</code> item from the popup menu.
9350
9351
<br><p>
8118
the variable name and select the ‘<samp><span class="samp">Print</span></samp>’ item from the popup menu.
8119
8120
<pre class="sp">
8121
8122
</pre>
9352
8123
<div align="center"><img src="PICS/ddd-print-popup.jpg" alt="PICS/ddd-print-popup.jpg"></div>
9353
<br><p>
9354
<p>In <small>GDB</small>, the <code>Print</code> button generates a <code>print</code> command, which
9355
has several more options. See <a href="gdb.html#Data">Examining Data</a>, for <small>GDB</small>-specific expressions, variables, and
8124
<pre class="sp">
8125
8126
</pre>
8127
8128
<a name="index-print-884"></a><a name="index-Print_002c-output-formats-885"></a>In <acronym>GDB</acronym>, the ‘<samp><span class="samp">Print</span></samp>’ button generates a <samp><span class="command">print</span></samp> command, which
8129
has several more options. See <a href="gdb.html#Data">Examining Data</a>, for <acronym>GDB</acronym>-specific expressions, variables, and
9356
8130
output formats.
9357
8131
9358
8132
<div class="node">
9359
8133
<p><hr>
9360
<small class=header>
9361
Node:<a name="Displaying%20Values">Displaying Values</a>,
9362
Next:<a rel="next" accesskey="n" href="#Plotting%20Values">Plotting Values</a>,
9363
Previous:<a rel="previous" accesskey="p" href="#Printing%20Values">Printing Values</a>,
9364
Up:<a rel="up" accesskey="u" href="#Examining%20Data">Examining Data</a>
8134
<a name="Displaying-Values"></a>
8135
Next: <a rel="next" accesskey="n" href="#Plotting-Values">Plotting Values</a>,
8136
Previous: <a rel="previous" accesskey="p" href="#Printing-Values">Printing Values</a>,
8137
Up: <a rel="up" accesskey="u" href="#Examining-Data">Examining Data</a>
9365
8138
</small>
9366
8139
9367
<br>
8140
9368
8141
</div>
9369
8142
9370
<h3 class="section">Displaying Complex Values in the Data Window</h3>
8143
<h3 class="section">7.3 Displaying Complex Values in the Data Window</h3>
9371
8144
9372
<p>To explore complex data structures, you can <dfn>display</dfn> them
8145
<p><a name="index-Data-Window-886"></a><a name="index-Value_002c-displaying-887"></a><a name="index-Display-888"></a><a name="index-Displaying-values-889"></a>
8146
To explore complex data structures, you can <dfn>display</dfn> them
9373
8147
permanently in the <em>data window</em>. The data window displays
9374
8148
selected data of your program, showing complex data structures
9375
8149
graphically. It is updated each time the program stops.
9376
8150
9377
8151
<ul class="menu">
9378
<li><a accesskey="1" href="#Display%20Basics">Display Basics</a>: How to create, manipulate, and delete displays.
8152
<li><a accesskey="1" href="#Display-Basics">Display Basics</a>: How to create, manipulate, and delete displays.
9379
8153
<li><a accesskey="2" href="#Arrays">Arrays</a>: Special functions for arrays.
9380
8154
<li><a accesskey="3" href="#Assignment">Assignment</a>: Setting variable values.
9381
<li><a accesskey="4" href="#Examining%20Structures">Examining Structures</a>: Dereferencing pointers and other references.
9382
<li><a accesskey="5" href="#Customizing%20Displays">Customizing Displays</a>: Data Themes.
9383
<li><a accesskey="6" href="#Layouting%20the%20Graph">Layouting the Graph</a>: Automatic layout.
9384
<li><a accesskey="7" href="#Printing%20the%20Graph">Printing the Graph</a>: Printing on paper.
8155
<li><a accesskey="4" href="#Examining-Structures">Examining Structures</a>: Dereferencing pointers and other references.
8156
<li><a accesskey="5" href="#Customizing-Displays">Customizing Displays</a>: Data Themes.
8157
<li><a accesskey="6" href="#Layouting-the-Graph">Layouting the Graph</a>: Automatic layout.
8158
<li><a accesskey="7" href="#Printing-the-Graph">Printing the Graph</a>: Printing on paper.
9385
8159
</ul>
9386
8160
9387
8161
<div class="node">
9388
8162
<p><hr>
9389
<small class=header>
9390
Node:<a name="Display%20Basics">Display Basics</a>,
9391
Next:<a rel="next" accesskey="n" href="#Arrays">Arrays</a>,
9392
Up:<a rel="up" accesskey="u" href="#Displaying%20Values">Displaying Values</a>
8163
<a name="Display-Basics"></a>
8164
Next: <a rel="next" accesskey="n" href="#Arrays">Arrays</a>,
8165
Up: <a rel="up" accesskey="u" href="#Displaying-Values">Displaying Values</a>
9393
8166
</small>
9394
8167
9395
<br>
8168
9396
8169
</div>
9397
8170
9398
<h4 class="subsection">Display Basics</h4>
8171
<h4 class="subsection">7.3.1 Display Basics</h4>
9399
8172
9400
<p>This section discusses how to create, manipulate, and delete displays.
8173
<p>This section discusses how to create, manipulate, and delete displays.
9401
8174
The essentials are:
9402
8175
9403
8176
<ul>
9404
<li>Click on <code>Display</code> to display the variable in <code>()</code>.
8177
<li><a name="index-Display-890"></a>Click on ‘<samp><span class="samp">Display</span></samp>’ to display the variable in ‘<samp><span class="samp">()</span></samp>’.
9405
8178
9406
8179
<li>Click on a display to select it.
9407
8180
9408
<li>Click on <code>Undisplay</code> to delete the selected display.
9409
</ul>
8181
<li>Click on ‘<samp><span class="samp">Undisplay</span></samp>’ to delete the selected display.
8182
<a name="index-Undisplay-891"></a></ul>
9410
8183
9411
8184
<ul class="menu">
9412
<li><a accesskey="1" href="#Creating%20Single%20Displays">Creating Single Displays</a>:
9413
<li><a accesskey="2" href="#Selecting%20Displays">Selecting Displays</a>:
9414
<li><a accesskey="3" href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>:
9415
<li><a accesskey="4" href="#Rotating%20Displays">Rotating Displays</a>:
9416
<li><a accesskey="5" href="#Displaying%20Local%20Variables">Displaying Local Variables</a>:
9417
<li><a accesskey="6" href="#Displaying%20Program%20Status">Displaying Program Status</a>:
9418
<li><a accesskey="7" href="#Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>:
9419
<li><a accesskey="8" href="#Placement">Placement</a>:
9420
<li><a accesskey="9" href="#Clustering">Clustering</a>:
9421
<li><a href="#Creating%20Multiple%20Displays">Creating Multiple Displays</a>:
9422
<li><a href="#Editing%20all%20Displays">Editing all Displays</a>:
9423
<li><a href="#Deleting%20Displays">Deleting Displays</a>:
8185
<li><a accesskey="1" href="#Creating-Single-Displays">Creating Single Displays</a>
8186
<li><a accesskey="2" href="#Selecting-Displays">Selecting Displays</a>
8187
<li><a accesskey="3" href="#Showing-and-Hiding-Details">Showing and Hiding Details</a>
8188
<li><a accesskey="4" href="#Rotating-Displays">Rotating Displays</a>
8189
<li><a accesskey="5" href="#Displaying-Local-Variables">Displaying Local Variables</a>
8190
<li><a accesskey="6" href="#Displaying-Program-Status">Displaying Program Status</a>
8191
<li><a accesskey="7" href="#Refreshing-the-Data-Window">Refreshing the Data Window</a>
8192
<li><a accesskey="8" href="#Placement">Placement</a>
8193
<li><a accesskey="9" href="#Clustering">Clustering</a>
8194
<li><a href="#Creating-Multiple-Displays">Creating Multiple Displays</a>
8195
<li><a href="#Editing-all-Displays">Editing all Displays</a>
8196
<li><a href="#Deleting-Displays">Deleting Displays</a>
9424
8197
</ul>
9425
8198
9426
8199
<div class="node">
9427
8200
<p><hr>
9428
<small class=header>
9429
Node:<a name="Creating%20Single%20Displays">Creating Single Displays</a>,
9430
Next:<a rel="next" accesskey="n" href="#Selecting%20Displays">Selecting Displays</a>,
9431
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8201
<a name="Creating-Single-Displays"></a>
8202
Next: <a rel="next" accesskey="n" href="#Selecting-Displays">Selecting Displays</a>,
8203
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
9432
8204
</small>
9433
8205
9434
<br>
8206
9435
8207
</div>
9436
8208
9437
<h5 class="subsubsection">Creating Single Displays</h5>
8209
<h5 class="subsubsection">7.3.1.1 Creating Single Displays</h5>
9438
8210
9439
<p>To create a new display showing a specific variable, select the variable
8211
<p><a name="index-Display_002c-creating-892"></a><a name="index-Display-893"></a>
8212
To create a new display showing a specific variable, select the variable
9440
8213
by clicking <em>mouse button 1</em> on its name. The variable name is
9441
copied to the argument field. By clicking the <code>Display</code> button, a
8214
copied to the argument field. By clicking the ‘<samp><span class="samp">Display</span></samp>’ button, a
9442
8215
new display is created in the data window. The data window opens
9443
8216
automatically as soon as you create a display.
9444
8217
9445
<br><p>
8218
<pre class="sp">
8219
8220
</pre>
9446
8221
<div align="center"><img src="PICS/ddd-display.jpg" alt="PICS/ddd-display.jpg"></div>
9447
<br><p>
9448
<p>As a shorter alternative, you can simply press <em>mouse button 3</em> on
9449
the variable name and select <code>Display</code> from the popup menu.
8222
<pre class="sp">
8223
8224
</pre>
8225
8226
<a name="index-Display-894"></a>As a shorter alternative, you can simply press <em>mouse button 3</em> on
8227
the variable name and select ‘<samp><span class="samp">Display</span></samp>’ from the popup menu.
9450
8228
9451
8229
<p>As an even faster alternative, you can also double-click on the variable
9452
8230
name.
9453
8231
9454
8232
<p>As another alternative, you may also enter the expression to be
9455
displayed in the argument field and press the <code>Display</code> button.
8233
displayed in the argument field and press the ‘<samp><span class="samp">Display</span></samp>’ button.
9456
8234
9457
8235
<p>Finally, you may also type in a command at the debugger prompt:
9458
8236
8237
<p><a name="index-graph-display-895"></a>
9459
8238
<pre class="example"> graph display <var>expr</var> [clustered] [at (<var>x</var>, <var>y</var>)]
9460
8239
[dependent on <var>display</var>] [[now or] when in <var>scope</var>]
9461
</pre>
9462
8240
</pre>
9463
8241
<p>This command creates a new display showing the value of the expression
9464
8242
<var>expr</var>. The optional parts have the following meaning:
9465
8243
9466
8244
<dl>
9467
<dt><code>clustered</code>
9468
<dd>If given, the new display is created in a cluster. See <a href="#Clustering">Clustering</a>,
8245
<dt><code>clustered</code><dd><a name="index-Clustered-display_002c-creating-896"></a><a name="index-Display_002c-clustered-897"></a>If given, the new display is created in a cluster. See <a href="#Clustering">Clustering</a>,
9469
8246
for a discussion.
9470
8247
9471
<br><dt><code>at (</code><var>x</var><code>, </code><var>y</var><code>)</code>
9472
<dd>If given, the new display is created at the position (<var>x</var>, <var>y</var>).
8248
<br><dt><code>at (</code><var>x</var><code>, </code><var>y</var><code>)</code><dd><a name="index-Display-position-898"></a><a name="index-Position_002c-of-display-899"></a>If given, the new display is created at the position (<var>x</var>, <var>y</var>).
9473
8249
Otherwise, a default position is assigned.
9474
8250
9475
<br><dt><code>dependent on </code><var>display</var><code></code>
9476
<dd>If given, an edge from the display numbered or named <em>display</em> to
8251
<br><dt><code>dependent on </code><var>display</var><dd><a name="index-Dependent-display-900"></a><a name="index-Display_002c-dependent-901"></a>If given, an edge from the display numbered or named <em>display</em> to
9477
8252
the new display is created. Otherwise, no edge is created.
9478
See <a href="#Dependent%20Values">Dependent Values</a>, for details.
8253
See <a href="#Dependent-Values">Dependent Values</a>, for details.
9479
8254
9480
<br><dt><code>when in </code><var>scope</var><code></code>
9481
<dd><dt><code>now or when in </code><var>scope</var><code></code>
9482
<dd>If <code>when in</code> is given, the display creation is <dfn>deferred</dfn> until
8255
<br><dt><code>when in </code><var>scope</var><dt><code>now or when in </code><var>scope</var><dd><a name="index-Deferred-display-902"></a><a name="index-Display_002c-deferred-903"></a>If ‘<samp><span class="samp">when in</span></samp>’ is given, the display creation is <dfn>deferred</dfn> until
9483
8256
execution reaches the given <var>scope</var> (a function name, as in the
9484
8257
backtrace output).
9485
8258
9486
<p>If <code>now or when in</code> is given, <small>DDD</small> first attempts to create
8259
<p>If ‘<samp><span class="samp">now or when in</span></samp>’ is given, <acronym>DDD</acronym> first attempts to create
9487
8260
the display immediately. The display is deferred only if display
9488
8261
creation fails.
9489
8262
9490
<p>If neither <code>when in</code> suffix nor <code>now or when in</code> suffix is
8263
<p>If neither ‘<samp><span class="samp">when in</span></samp>’ suffix nor ‘<samp><span class="samp">now or when in</span></samp>’ suffix is
9491
8264
given, the display is created immediately.
9492
8265
</dl>
9493
8266
9494
8267
<div class="node">
9495
8268
<p><hr>
9496
<small class=header>
9497
Node:<a name="Selecting%20Displays">Selecting Displays</a>,
9498
Next:<a rel="next" accesskey="n" href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>,
9499
Previous:<a rel="previous" accesskey="p" href="#Creating%20Single%20Displays">Creating Single Displays</a>,
9500
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8269
<a name="Selecting-Displays"></a>
8270
Next: <a rel="next" accesskey="n" href="#Showing-and-Hiding-Details">Showing and Hiding Details</a>,
8271
Previous: <a rel="previous" accesskey="p" href="#Creating-Single-Displays">Creating Single Displays</a>,
8272
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
9501
8273
</small>
9502
8274
9503
<br>
8275
9504
8276
</div>
9505
8277
9506
<h5 class="subsubsection">Selecting Displays</h5>
8278
<h5 class="subsubsection">7.3.1.2 Selecting Displays</h5>
9507
8279
9508
<p>Each display in the data window has a <em>title bar</em> containing the
8280
<p><a name="index-Display-title-904"></a><a name="index-Title_002c-display-905"></a><a name="index-Display-name-906"></a><a name="index-Name_002c-display-907"></a><a name="index-Display-value-908"></a><a name="index-Value_002c-display-909"></a>Each display in the data window has a <em>title bar</em> containing the
9509
8281
<em>display number</em> and the displayed expression (the <em>display
9510
8282
name</em>). Below the title, the <em>display value</em> is shown.
9511
8283
9512
<p>You can select single displays by clicking on them with <em>mouse
8284
<p><a name="index-Display_002c-selecting-910"></a><a name="index-Selecting-single-displays-911"></a>You can select single displays by clicking on them with <em>mouse
9513
8285
button 1</em>.
9514
8286
9515
<p>You can <em>extend</em> an existing selection by pressing the <Shift>
8287
<p><a name="index-Extending-display-selection-912"></a><a name="index-Display-selection-913"></a><a name="index-Shift-914"></a>You can <em>extend</em> an existing selection by pressing the <Shift>
9516
8288
key while selecting. You can also <em>toggle</em> an existing selection
9517
8289
by pressing the <Shift> key while selecting already selected
9518
8290
displays.
9519
8291
9520
<p>Single displays may also be selected by using the arrow keys <Up>,
8292
<p><a name="index-Up-915"></a><a name="index-Down-916"></a><a name="index-Left-917"></a><a name="index-Right-918"></a>Single displays may also be selected by using the arrow keys <Up>,
9521
8293
<Down>, <Left>, and <Right>.
9522
8294
9523
<p><em>Multiple displays</em> are selected by pressing and holding
8295
<p><a name="index-Selecting-multiple-displays-919"></a><em>Multiple displays</em> are selected by pressing and holding
9524
8296
<em>mouse button 1</em> somewhere on the window background. By moving the
9525
8297
pointer while holding the button, a selection rectangle is shown; all
9526
8298
displays fitting in the rectangle are selected when mouse button 1 is
9527
8299
released.
9528
8300
9529
<p>If the <Shift> key is pressed while selecting, the existing
8301
<p><a name="index-Shift-920"></a>If the <Shift> key is pressed while selecting, the existing
9530
8302
selection is <em>extended</em>.
9531
8303
9532
8304
<p>By double-clicking on a display title, the display itself and all
9533
8305
connected displays are automatically selected.
9534
8306
9535
<br><p>
8307
<pre class="sp">
8308
8309
</pre>
9536
8310
<div align="center"><img src="PICS/ddd-select-display.jpg" alt="PICS/ddd-select-display.jpg"></div>
9537
<br><p>
8311
<pre class="sp">
8312
8313
</pre>
8314
9538
8315
<div class="node">
9539
8316
<p><hr>
9540
<small class=header>
9541
Node:<a name="Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>,
9542
Next:<a rel="next" accesskey="n" href="#Rotating%20Displays">Rotating Displays</a>,
9543
Previous:<a rel="previous" accesskey="p" href="#Selecting%20Displays">Selecting Displays</a>,
9544
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8317
<a name="Showing-and-Hiding-Details"></a>
8318
Next: <a rel="next" accesskey="n" href="#Rotating-Displays">Rotating Displays</a>,
8319
Previous: <a rel="previous" accesskey="p" href="#Selecting-Displays">Selecting Displays</a>,
8320
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
9545
8321
</small>
9546
8322
9547
<br>
8323
9548
8324
</div>
9549
8325
9550
<h5 class="subsubsection">Showing and Hiding Details</h5>
8326
<h5 class="subsubsection">7.3.1.3 Showing and Hiding Details</h5>
9551
8327
9552
<p>Aggregate values (i.e. records, structs, classes, and arrays) can be
8328
<p>Aggregate values (i.e. records, structs, classes, and arrays) can be
9553
8329
shown <em>expanded</em>, that is, displaying all details, or
9554
<em>hidden</em>, that is, displayed as <code>{...}</code>.
8330
<em>hidden</em>, that is, displayed as ‘<samp><span class="samp">{...}</span></samp>’.
9555
8331
9556
<p>To show details about an aggregate, select the aggregate by clicking
9557
<em>mouse button 1</em> on its name or value and click on the <code>Show</code>
8332
<p><a name="index-Show-921"></a><a name="index-Display_002c-showing-details-922"></a><a name="index-Detail_002c-showing-923"></a><a name="index-Showing-display-details-924"></a>To show details about an aggregate, select the aggregate by clicking
8333
<em>mouse button 1</em> on its name or value and click on the ‘<samp><span class="samp">Show</span></samp>’
9558
8334
button. Details are shown for the aggregate itself as well as for all
9559
8335
contained sub-aggregates.
9560
8336
9561
<p>To hide details about an aggregate, select the aggregate by clicking
9562
<em>mouse button 1</em> on its name or value and click on the <code>Hide</code>
8337
<p><a name="index-Hide-925"></a><a name="index-Display_002c-hiding-details-926"></a><a name="index-Detail_002c-hiding-927"></a><a name="index-Hiding-display-details-928"></a>To hide details about an aggregate, select the aggregate by clicking
8338
<em>mouse button 1</em> on its name or value and click on the ‘<samp><span class="samp">Hide</span></samp>’
9563
8339
button.
9564
8340
9565
<br><p>
8341
<pre class="sp">
8342
8343
</pre>
9566
8344
<div align="center"><img src="PICS/ddd-hide-display.jpg" alt="PICS/ddd-hide-display.jpg"></div>
9567
<br><p>
9568
<p>When pressing and holding <em>mouse button 1</em> on the <code>Show/Hide</code>
8345
<pre class="sp">
8346
8347
</pre>
8348
8349
When pressing and holding <em>mouse button 1</em> on the ‘<samp><span class="samp">Show/Hide</span></samp>’
9569
8350
button, a menu pops up with even more alternatives:
9570
8351
9571
8352
<dl>
9572
<dt><code>Show More ()</code>
9573
<dd>Shows details of all aggregates currently hidden, but not of their
8353
<dt><code>Show More ()</code><dd><a name="index-Show-More-929"></a>Shows details of all aggregates currently hidden, but not of their
9574
8354
sub-aggregates. You can invoke this item several times in a row to
9575
8355
reveal more and more details of the selected aggregate.
9576
8356
9577
<br><dt><code>Show Just ()</code>
9578
<dd>Shows details of the selected aggregate, but hides all sub-aggregates.
9579
9580
<br><dt><code>Show All ()</code>
9581
<dd>Shows all details of the selected aggregate and of its sub-aggregates.
9582
This item is equivalent to the <code>Show</code> button.
9583
9584
<br><dt><code>Hide ()</code>
9585
<dd>Hide all details of the selected aggregate. This item is equivalent
9586
to the <code>Hide</code> button.
9587
</dl>
8357
<br><dt><code>Show Just ()</code><dd><a name="index-Show-Just-930"></a>Shows details of the selected aggregate, but hides all sub-aggregates.
8358
8359
<br><dt><code>Show All ()</code><dd><a name="index-Show-All-931"></a>Shows all details of the selected aggregate and of its sub-aggregates.
8360
This item is equivalent to the ‘<samp><span class="samp">Show</span></samp>’ button.
8361
8362
<br><dt><code>Hide ()</code><dd>Hide all details of the selected aggregate. This item is equivalent
8363
to the ‘<samp><span class="samp">Hide</span></samp>’ button.
8364
<a name="index-Hide-932"></a></dl>
9588
8365
9589
8366
<p>As a faster alternative, you can also press <em>mouse button 3</em> on the
9590
8367
aggregate and select the appropriate menu item.
9595
8372
<em>hide</em> the value instead. This way, you can double-click on a
9596
8373
value until you get the right amount of details.
9597
8374
9598
<p>If <em>all</em> details of a display are hidden, the display is called
9599
<dfn>disabled</dfn>; this is indicated by the string <code>(Disabled)</code>.
8375
<p><a name="index-Disabled-displays-933"></a><a name="index-Display_002c-disabled-934"></a>If <em>all</em> details of a display are hidden, the display is called
8376
<dfn>disabled</dfn>; this is indicated by the string ‘<samp><span class="samp">(Disabled)</span></samp>’.
9600
8377
9601
<p>Displays can also be disabled or enabled via a <small>DDD</small> command,
8378
<p>Displays can also be disabled or enabled via a <acronym>DDD</acronym> command,
9602
8379
which you enter at the debugger prompt:
9603
8380
8381
<p><a name="index-graph-disable-display-935"></a>
9604
8382
<pre class="example"> graph disable display <var>displays<small class="dots">...</small></var>
9605
</pre>
9606
9607
<p>disables the given displays.
9608
8383
</pre>
8384
<p class="noindent">disables the given displays.
8385
8386
<p><a name="index-graph-enable-display-936"></a>
9609
8387
<pre class="example"> graph enable display <var>displays<small class="dots">...</small></var>
9610
</pre>
9611
9612
<p>re-enables the given displays.
8388
</pre>
8389
<p class="noindent">re-enables the given displays.
9613
8390
9614
8391
<p>In both commands, <var>displays<small class="dots">...</small></var> is either
9615
8392
<ul>
9619
8396
with this name will be affected.
9620
8397
</ul>
9621
8398
9622
<p>Use <code>Edit => Undo</code> to undo disabling or enabling displays.
8399
<p><a name="index-Undo-disabling-displays-937"></a><a name="index-Disabling-displays_002c-undoing-938"></a><a name="index-Undo-939"></a>Use ‘<samp><span class="samp">Edit Undo</span></samp>’ to undo disabling or enabling displays.
9623
8400
9624
8401
<div class="node">
9625
8402
<p><hr>
9626
<small class=header>
9627
Node:<a name="Rotating%20Displays">Rotating Displays</a>,
9628
Next:<a rel="next" accesskey="n" href="#Displaying%20Local%20Variables">Displaying Local Variables</a>,
9629
Previous:<a rel="previous" accesskey="p" href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>,
9630
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8403
<a name="Rotating-Displays"></a>
8404
Next: <a rel="next" accesskey="n" href="#Displaying-Local-Variables">Displaying Local Variables</a>,
8405
Previous: <a rel="previous" accesskey="p" href="#Showing-and-Hiding-Details">Showing and Hiding Details</a>,
8406
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
9631
8407
</small>
9632
8408
9633
<br>
8409
9634
8410
</div>
9635
8411
9636
<h5 class="subsubsection">Rotating Displays</h5>
8412
<h5 class="subsubsection">7.3.1.4 Rotating Displays</h5>
9637
8413
9638
<p>Arrays, structures and lists can be oriented horizontally or vertically.
8414
<p><a name="index-Display_002c-rotating-940"></a>
8415
Arrays, structures and lists can be oriented horizontally or vertically.
9639
8416
To change the orientation of a display, select it and then click on the
9640
<code>Rotate</code> button.
8417
‘<samp><span class="samp">Rotate</span></samp>’ button.
9641
8418
9642
8419
<p>As a faster alternative, you can also press <em>mouse button 3</em> on the
9643
array and select <code>Rotate</code> from the popup menu.
9644
9645
<br><p>
8420
array and select ‘<samp><span class="samp">Rotate</span></samp>’ from the popup menu.
8421
8422
<pre class="sp">
8423
8424
</pre>
9646
8425
<div align="center"><img src="PICS/ddd-rotate-display.jpg" alt="PICS/ddd-rotate-display.jpg"></div>
9647
<br><p>
9648
<p>If a structure or list is oriented horizontally, <small>DDD</small>
8426
<pre class="sp">
8427
8428
</pre>
8429
8430
If a structure or list is oriented horizontally, <acronym>DDD</acronym>
9649
8431
automatically suppresses the member names. This can be handy for saving
9650
8432
space.
9651
8433
9654
8436
the next array you create will also be oriented horizontally. These
9655
8437
settings are tied to the following resources:
9656
8438
9657
<p>
9658
<table width="100%">
9659
<tr>
9660
<td align="left"><b>arrayOrientation</b><i> </i>(<i>class Orientation</i>)<i>
9661
</i></td>
9662
<td align="right">Resource</td>
9663
</tr>
9664
</table>
9665
<table width="95%" align="center">
9666
<tr><td>
9667
How arrays are to be oriented. Possible values are <code>XmVERTICAL</code>
9668
(default) and <code>XmHORIZONTAL</code>.
9669
</td></tr>
9670
</table>
9671
9672
<p>
9673
<table width="100%">
9674
<tr>
9675
<td align="left"><b>showMemberNames</b><i> </i>(<i>class ShowMemberNames</i>)<i>
9676
</i></td>
9677
<td align="right">Resource</td>
9678
</tr>
9679
</table>
9680
<table width="95%" align="center">
9681
<tr><td>
9682
Whether to show struct member names or not. Default is <code>on</code>.
9683
</td></tr>
9684
</table>
9685
9686
<p>
9687
<table width="100%">
9688
<tr>
9689
<td align="left"><b>structOrientation</b><i> </i>(<i>class Orientation</i>)<i>
9690
</i></td>
9691
<td align="right">Resource</td>
9692
</tr>
9693
</table>
9694
<table width="95%" align="center">
9695
<tr><td>
9696
How structs are to be oriented. Possible values are <code>XmVERTICAL</code>
9697
(default) and <code>XmHORIZONTAL</code>.
9698
</td></tr>
9699
</table>
8439
<div class="defun">
8440
— Resource: <b>arrayOrientation</b> (<var>class Orientation</var>)<var><a name="index-arrayOrientation-941"></a></var><br>
8441
<blockquote><p>How arrays are to be oriented. Possible values are ‘<samp><span class="samp">XmVERTICAL</span></samp>’
8442
(default) and ‘<samp><span class="samp">XmHORIZONTAL</span></samp>’.
8443
</p></blockquote></div>
8444
8445
<div class="defun">
8446
— Resource: <b>showMemberNames</b> (<var>class ShowMemberNames</var>)<var><a name="index-showMemberNames-942"></a></var><br>
8447
<blockquote><p>Whether to show struct member names or not. Default is ‘<samp><span class="samp">on</span></samp>’.
8448
</p></blockquote></div>
8449
8450
<div class="defun">
8451
— Resource: <b>structOrientation</b> (<var>class Orientation</var>)<var><a name="index-structOrientation-943"></a></var><br>
8452
<blockquote><p>How structs are to be oriented. Possible values are ‘<samp><span class="samp">XmVERTICAL</span></samp>’
8453
(default) and ‘<samp><span class="samp">XmHORIZONTAL</span></samp>’.
8454
</p></blockquote></div>
9700
8455
9701
8456
<div class="node">
9702
8457
<p><hr>
9703
<small class=header>
9704
Node:<a name="Displaying%20Local%20Variables">Displaying Local Variables</a>,
9705
Next:<a rel="next" accesskey="n" href="#Displaying%20Program%20Status">Displaying Program Status</a>,
9706
Previous:<a rel="previous" accesskey="p" href="#Rotating%20Displays">Rotating Displays</a>,
9707
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8458
<a name="Displaying-Local-Variables"></a>
8459
Next: <a rel="next" accesskey="n" href="#Displaying-Program-Status">Displaying Program Status</a>,
8460
Previous: <a rel="previous" accesskey="p" href="#Rotating-Displays">Rotating Displays</a>,
8461
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
9708
8462
</small>
9709
8463
9710
<br>
8464
9711
8465
</div>
9712
8466
9713
<h5 class="subsubsection">Displaying Local Variables</h5>
8467
<h5 class="subsubsection">7.3.1.5 Displaying Local Variables</h5>
9714
8468
9715
<p>You can display all local variables at once by choosing <code>Data
9716
=> Display Local Variables</code>. When using <small>DBX</small>, <small>XDB</small>, <small>JDB</small>, or Perl,
8469
<p><a name="index-Display-Local-Variables-944"></a><a name="index-Display-Arguments-945"></a><a name="index-Local-variables_002c-displaying-946"></a><a name="index-Arguments_002c-displaying-947"></a>
8470
You can display all local variables at once by choosing ‘<samp><span class="samp">Data
8471
Display Local Variables</span></samp>’. When using <acronym>DBX</acronym>, <acronym>XDB</acronym>, <acronym>JDB</acronym>, or Perl,
9717
8472
this displays all local variables, including the arguments of the
9718
current function. When using <small>GDB</small> or <small>PYDB</small>, function arguments are
9719
contained in a separate display, activated by <code>Data =>
9720
Display Arguments</code>.
8473
current function. When using <acronym>GDB</acronym> or <code>pydb</code>, function arguments are
8474
contained in a separate display, activated by ‘<samp><span class="samp">Data
8475
Display Arguments</span></samp>’.
9721
8476
9722
8477
<p>The display showing the local variables can be manipulated just like any
9723
8478
other data display. Individual variables can be selected and
9724
8479
dereferenced.
9725
8480
9726
<br><p>
8481
<pre class="sp">
8482
8483
</pre>
9727
8484
<div align="center"><img src="PICS/ddd-locals.jpg" alt="PICS/ddd-locals.jpg"></div>
9728
<br><p>
8485
<pre class="sp">
8486
8487
</pre>
8488
9729
8489
<div class="node">
9730
8490
<p><hr>
9731
<small class=header>
9732
Node:<a name="Displaying%20Program%20Status">Displaying Program Status</a>,
9733
Next:<a rel="next" accesskey="n" href="#Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>,
9734
Previous:<a rel="previous" accesskey="p" href="#Displaying%20Local%20Variables">Displaying Local Variables</a>,
9735
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8491
<a name="Displaying-Program-Status"></a>
8492
Next: <a rel="next" accesskey="n" href="#Refreshing-the-Data-Window">Refreshing the Data Window</a>,
8493
Previous: <a rel="previous" accesskey="p" href="#Displaying-Local-Variables">Displaying Local Variables</a>,
8494
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
9736
8495
</small>
9737
8496
9738
<br>
8497
9739
8498
</div>
9740
8499
9741
<h5 class="subsubsection">Displaying Program Status</h5>
8500
<h5 class="subsubsection">7.3.1.6 Displaying Program Status</h5>
9742
8501
9743
<p>You can create a display from the output of an arbitrary debugger
8502
<p>You can create a display from the output of an arbitrary debugger
9744
8503
command. By entering
9745
8504
8505
<p><a name="index-graph-display-948"></a>
9746
8506
<pre class="example"> graph display `<var>command</var>`
9747
</pre>
9748
9749
<p>the output of <var>command</var> is turned into a <em>status display</em>
8507
</pre>
8508
<p class="noindent"><a name="index-Status-display-949"></a>the output of <var>command</var> is turned into a <em>status display</em>
9750
8509
updated each time the program stops.
9751
8510
9752
8511
<p>For instance, the command
9753
8512
9754
8513
<pre class="example"> graph display `where`
9755
</pre>
9756
9757
<p>creates a status display named <code>Where</code> that shows the current
8514
</pre>
8515
<p class="noindent">creates a status display named ‘<samp><span class="samp">Where</span></samp>’ that shows the current
9758
8516
backtrace.
9759
8517
9760
<p>If you are using <small>GDB</small>, <small>DDD</small> provides a panel from which you can
9761
choose useful status displays. Select <code>Data => Status
9762
Displays</code> and pick your choice from the list.
9763
9764
<br><p>
8518
<p><a name="index-Status-Displays-950"></a>If you are using <acronym>GDB</acronym>, <acronym>DDD</acronym> provides a panel from which you can
8519
choose useful status displays. Select ‘<samp><span class="samp">Data Status
8520
Displays</span></samp>’ and pick your choice from the list.
8521
8522
<pre class="sp">
8523
8524
</pre>
9765
8525
<div align="center"><img src="PICS/ddd-status-displays.jpg" alt="PICS/ddd-status-displays.jpg"></div>
9766
<br><p>
9767
<p>Refreshing status displays at each stop takes time; you should delete
8526
<pre class="sp">
8527
8528
</pre>
8529
8530
Refreshing status displays at each stop takes time; you should delete
9768
8531
status displays as soon as you don't need them any more.
9769
8532
9770
8533
<div class="node">
9771
8534
<p><hr>
9772
<small class=header>
9773
Node:<a name="Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>,
9774
Next:<a rel="next" accesskey="n" href="#Placement">Placement</a>,
9775
Previous:<a rel="previous" accesskey="p" href="#Displaying%20Program%20Status">Displaying Program Status</a>,
9776
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8535
<a name="Refreshing-the-Data-Window"></a>
8536
Next: <a rel="next" accesskey="n" href="#Placement">Placement</a>,
8537
Previous: <a rel="previous" accesskey="p" href="#Displaying-Program-Status">Displaying Program Status</a>,
8538
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
9777
8539
</small>
9778
8540
9779
<br>
8541
9780
8542
</div>
9781
8543
9782
<h5 class="subsubsection">Refreshing the Data Window</h5>
8544
<h5 class="subsubsection">7.3.1.7 Refreshing the Data Window</h5>
9783
8545
9784
<p>The data window is automatically updated or <dfn>refreshed</dfn> each time
8546
<p><a name="index-Display_002c-refreshing-951"></a><a name="index-Display_002c-updating-952"></a><a name="index-Refreshing-displayed-values-953"></a><a name="index-Updating-displayed-values-954"></a>
8547
The data window is automatically updated or <dfn>refreshed</dfn> each time
9785
8548
the program stops. Values that have changed since the last refresh are
9786
8549
highlighted.
9787
8550
9790
8553
debugger settings that could affect the data format, and want the data
9791
8554
window to reflect these settings.
9792
8555
9793
<p>You can refresh the data window by selecting <code>Data =>
9794
Refresh Displays</code>.
8556
<p><a name="index-Refresh-Displays-955"></a>You can refresh the data window by selecting ‘<samp><span class="samp">Data
8557
Refresh Displays</span></samp>’.
9795
8558
9796
<p>As an alternative, you can press <em>mouse button 3</em> on the background
9797
of the data window and select the <code>Refresh Displays</code> item.
8559
<p><a name="index-Refresh-Displays-956"></a>As an alternative, you can press <em>mouse button 3</em> on the background
8560
of the data window and select the ‘<samp><span class="samp">Refresh Displays</span></samp>’ item.
9798
8561
9799
8562
<p>Typing
9800
8563
8564
<p><a name="index-graph-refresh-957"></a>
9801
8565
<pre class="example"> graph refresh
9802
</pre>
9803
9804
<p>at the debugger prompt has the same effect.
8566
</pre>
8567
<p class="noindent">at the debugger prompt has the same effect.
9805
8568
9806
8569
<div class="node">
9807
8570
<p><hr>
9808
<small class=header>
9809
Node:<a name="Placement">Placement</a>,
9810
Next:<a rel="next" accesskey="n" href="#Clustering">Clustering</a>,
9811
Previous:<a rel="previous" accesskey="p" href="#Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>,
9812
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8571
<a name="Placement"></a>
8572
Next: <a rel="next" accesskey="n" href="#Clustering">Clustering</a>,
8573
Previous: <a rel="previous" accesskey="p" href="#Refreshing-the-Data-Window">Refreshing the Data Window</a>,
8574
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
9813
8575
</small>
9814
8576
9815
<br>
8577
9816
8578
</div>
9817
8579
9818
<h5 class="subsubsection">Display Placement</h5>
8580
<h5 class="subsubsection">7.3.1.8 Display Placement</h5>
9819
8581
9820
<p>By default, displays are created from <em>top to bottom</em>--that is,
8582
<p><a name="index-Display_002c-placement-958"></a><a name="index-Placement-959"></a>
8583
<a name="index-Left-to-right-960"></a><a name="index-Top-to-bottom-961"></a><a name="index-Placement-962"></a>By default, displays are created from <em>top to bottom</em>—that is,
9821
8584
each new display is placed below the downmost one. You can change this
9822
setting to <em>left to right</em> via <code>Edit => Preferences
9823
=> Data => Placement => Left to right</code>.
9824
9825
<br><p>
8585
setting to <em>left to right</em> via ‘<samp><span class="samp">Edit Preferences
8586
Data Placement Left to right</span></samp>’.
8587
8588
<pre class="sp">
8589
8590
</pre>
9826
8591
<div align="center"><img src="PICS/ddd-data-prefs.jpg" alt="PICS/ddd-data-prefs.jpg"></div>
9827
<br><p>
9828
<p>This setting is tied to the following resource:
9829
9830
<p>
9831
<table width="100%">
9832
<tr>
9833
<td align="left"><b>displayPlacement</b><i> </i>(<i>class Orientation</i>)<i>
9834
</i></td>
9835
<td align="right">Resource</td>
9836
</tr>
9837
</table>
9838
<table width="95%" align="center">
9839
<tr><td>
9840
If this is <code>XmVERTICAL</code> (default), <small>DDD</small> places each new
8592
<pre class="sp">
8593
8594
</pre>
8595
8596
This setting is tied to the following resource:
8597
8598
<div class="defun">
8599
— Resource: <b>displayPlacement</b> (<var>class Orientation</var>)<var><a name="index-displayPlacement-963"></a></var><br>
8600
<blockquote><p>If this is ‘<samp><span class="samp">XmVERTICAL</span></samp>’ (default), <acronym>DDD</acronym> places each new
9841
8601
independent display below the downmost one. If this is
9842
<code>XmHORIZONTAL</code>, each new independent display is placed on the right
8602
‘<samp><span class="samp">XmHORIZONTAL</span></samp>’, each new independent display is placed on the right
9843
8603
of the rightmost one.
9844
</td></tr>
9845
</table>
8604
</p></blockquote></div>
9846
8605
9847
8606
<p>Note that changing the placement of new displays also affects the
9848
placement of <em>dependent displays</em> (see <a href="#Dependent%20Values">Dependent Values</a>). In
8607
placement of <em>dependent displays</em> (see <a href="#Dependent-Values">Dependent Values</a>). In
9849
8608
<em>top to bottom</em> mode, dependent displays are created on the right
9850
8609
of the originating display; in <em>left to right</em> mode, dependent
9851
8610
displays are created on the below the originating display.
9852
8611
9853
8612
<div class="node">
9854
8613
<p><hr>
9855
<small class=header>
9856
Node:<a name="Clustering">Clustering</a>,
9857
Next:<a rel="next" accesskey="n" href="#Creating%20Multiple%20Displays">Creating Multiple Displays</a>,
9858
Previous:<a rel="previous" accesskey="p" href="#Placement">Placement</a>,
9859
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8614
<a name="Clustering"></a>
8615
Next: <a rel="next" accesskey="n" href="#Creating-Multiple-Displays">Creating Multiple Displays</a>,
8616
Previous: <a rel="previous" accesskey="p" href="#Placement">Placement</a>,
8617
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
9860
8618
</small>
9861
8619
9862
<br>
8620
9863
8621
</div>
9864
8622
9865
<h5 class="subsubsection">Clustering Displays</h5>
8623
<h5 class="subsubsection">7.3.1.9 Clustering Displays</h5>
9866
8624
9867
<p>If you examine several variables at once, having a separate display for
9868
each of them uses a lot of screen space. This is why <small>DDD</small>
8625
<p><a name="index-Cluster-964"></a><a name="index-Display_002c-clustering-965"></a>
8626
If you examine several variables at once, having a separate display for
8627
each of them uses a lot of screen space. This is why <acronym>DDD</acronym>
9869
8628
supports <dfn>clusters</dfn>. A cluster merges several logical data displays
9870
8629
into one physical display, saving screen space.
9871
8630
9872
8631
<p>There are two ways to create clusters:
9873
8632
<ul>
9874
<li>You can create clusters <em>manually</em>. This is done by selecting the
9875
displays to be clustered and choosing <code>Undisp => Cluster
9876
()</code>. This creates a new cluster from all selected displays. If an
8633
<li><a name="index-Cluster-966"></a>You can create clusters <em>manually</em>. This is done by selecting the
8634
displays to be clustered and choosing ‘<samp><span class="samp">Undisp Cluster
8635
()</span></samp>’. This creates a new cluster from all selected displays. If an
9877
8636
already existing cluster is selected, too, the selected displays will be
9878
8637
clustered into the selected cluster.
9879
8638
9880
<li>You can create a cluster <em>automatically</em> for all independent data
8639
<li><a name="index-Cluster-Data-Displays-967"></a>You can create a cluster <em>automatically</em> for all independent data
9881
8640
displays, such that all new data displays will automatically be
9882
clustered, too. This is achieved by enabling <code>Edit =>
9883
Preferences => Data => Placement => clustered</code>.
8641
clustered, too. This is achieved by enabling ‘<samp><span class="samp">Edit
8642
Preferences Data Placement clustered</span></samp>’.
9884
8643
</ul>
9885
8644
9886
<br><p>
8645
<pre class="sp">
8646
8647
</pre>
9887
8648
<div align="center"><img src="PICS/ddd-clusters.jpg" alt="PICS/ddd-clusters.jpg"></div>
9888
<br><p>
9889
<p>Displays in a cluster can be selected and manipulated like parts of an
8649
<pre class="sp">
8650
8651
</pre>
8652
8653
Displays in a cluster can be selected and manipulated like parts of an
9890
8654
ordinary display; in particular, you can show and hide details, or
9891
8655
dereference pointers. However, edges leading to clustered displays can
9892
8656
not be shown, and you must either select one or all clustered displays.
9895
8659
are two ways of doing it:
9896
8660
9897
8661
<ul>
9898
<li>You can uncluster displays <em>manually</em>, by selecting the cluster
9899
and choosing <code>Undisp => Uncluster ()</code>.
8662
<li><a name="index-Uncluster-968"></a>You can uncluster displays <em>manually</em>, by selecting the cluster
8663
and choosing ‘<samp><span class="samp">Undisp Uncluster ()</span></samp>’.
9900
8664
9901
8665
<li>You can uncluster all current and future displays by disabling
9902
<code>Edit => Preferences => Data => Placement =>
9903
clustered</code>.
9904
</ul>
8666
‘<samp><span class="samp">Edit Preferences Data Placement
8667
clustered</span></samp>’.
8668
<a name="index-clustered-969"></a><a name="index-Placement-970"></a></ul>
9905
8669
9906
8670
<div class="node">
9907
8671
<p><hr>
9908
<small class=header>
9909
Node:<a name="Creating%20Multiple%20Displays">Creating Multiple Displays</a>,
9910
Next:<a rel="next" accesskey="n" href="#Editing%20all%20Displays">Editing all Displays</a>,
9911
Previous:<a rel="previous" accesskey="p" href="#Clustering">Clustering</a>,
9912
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8672
<a name="Creating-Multiple-Displays"></a>
8673
Next: <a rel="next" accesskey="n" href="#Editing-all-Displays">Editing all Displays</a>,
8674
Previous: <a rel="previous" accesskey="p" href="#Clustering">Clustering</a>,
8675
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
9913
8676
</small>
9914
8677
9915
<br>
8678
9916
8679
</div>
9917
8680
9918
<h5 class="subsubsection">Creating Multiple Displays</h5>
8681
<h5 class="subsubsection">7.3.1.10 Creating Multiple Displays</h5>
9919
8682
9920
<p>To display several successive objects of the same type (a section of an
8683
<p>To display several successive objects of the same type (a section of an
9921
8684
array, or an array of dynamically determined size), you can use the
9922
notation <code></code><var>from</var><code>..</code><var>to</var><code></code> in display expressions.
8685
notation ‘<samp><var>from</var><span class="samp">..</span><var>to</var></samp>’ in display expressions.
9923
8686
9924
8687
<p><var>from</var> and <var>to</var> are numbers that denote the first and last
9925
8688
expression to display. Thus,
9926
8689
9927
8690
<pre class="example"> graph display argv[0..9]
9928
</pre>
9929
9930
<p>creates 10 new displays for <code>argv[0]</code>, <code>argv[1]</code>, <small class="dots">...</small>,
9931
<code>argv[9]</code>. The displays are clustered automatically
8691
</pre>
8692
<p class="noindent">creates 10 new displays for ‘<samp><span class="samp">argv[0]</span></samp>’, ‘<samp><span class="samp">argv[1]</span></samp>’, <small class="dots">...</small>,
8693
‘<samp><span class="samp">argv[9]</span></samp>’. The displays are clustered automatically
9932
8694
(see <a href="#Clustering">Clustering</a>), such that you can easily handle the set just like
9933
8695
an array.
9934
8696
9935
<p>The <code></code><var>from</var><code>..</code><var>to</var><code></code> notation can also be used multiple
8697
<p>The ‘<samp><var>from</var><span class="samp">..</span><var>to</var></samp>’ notation can also be used multiple
9936
8698
times. For instance,
9937
8699
9938
8700
<pre class="example"> graph display 1..5 * 1..5
9939
</pre>
9940
9941
<p>creates a handy small multiplication table.
9942
9943
<p>The <code></code><var>from</var><code>..</code><var>to</var><code></code> notation creates several displays, which
8701
</pre>
8702
<p class="noindent">creates a handy small multiplication table.
8703
8704
<p>The ‘<samp><var>from</var><span class="samp">..</span><var>to</var></samp>’ notation creates several displays, which
9944
8705
takes time to create and update. If you want to display only a part of
9945
an array, <em>array slices</em> are a more efficient way. See <a href="#Array%20Slices">Array Slices</a>, for a discussion.
8706
an array, <em>array slices</em> are a more efficient way. See <a href="#Array-Slices">Array Slices</a>, for a discussion.
9946
8707
9947
8708
<div class="node">
9948
8709
<p><hr>
9949
<small class=header>
9950
Node:<a name="Editing%20all%20Displays">Editing all Displays</a>,
9951
Next:<a rel="next" accesskey="n" href="#Deleting%20Displays">Deleting Displays</a>,
9952
Previous:<a rel="previous" accesskey="p" href="#Creating%20Multiple%20Displays">Creating Multiple Displays</a>,
9953
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8710
<a name="Editing-all-Displays"></a>
8711
Next: <a rel="next" accesskey="n" href="#Deleting-Displays">Deleting Displays</a>,
8712
Previous: <a rel="previous" accesskey="p" href="#Creating-Multiple-Displays">Creating Multiple Displays</a>,
8713
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
9954
8714
</small>
9955
8715
9956
<br>
8716
9957
8717
</div>
9958
8718
9959
<h5 class="subsubsection">Editing all Displays</h5>
9960
9961
<p>You can view the state of all displays by selecting <code>Data =>
9962
Displays</code>. This invokes the <dfn>Display Editor</dfn>.
9963
9964
<br><p>
8719
<h5 class="subsubsection">7.3.1.11 Editing all Displays</h5>
8720
8721
<p><a name="index-Display-Editor-971"></a>
8722
You can view the state of all displays by selecting ‘<samp><span class="samp">Data
8723
Displays</span></samp>’. This invokes the <dfn>Display Editor</dfn>.
8724
8725
<pre class="sp">
8726
8727
</pre>
9965
8728
<div align="center"><img src="PICS/ddd-edit-displays.jpg" alt="PICS/ddd-edit-displays.jpg"></div>
9966
<br><p>
9967
<p>The Display Editor shows the properties of each display, using the
8729
<pre class="sp">
8730
8731
</pre>
8732
8733
The Display Editor shows the properties of each display, using the
9968
8734
following fields:
9969
8735
9970
8736
<dl>
9971
<dt><code>Num</code>
9972
<dd>The display number.
9973
9974
<br><dt><code>Expression</code>
9975
<dd>The displayed expression.
9976
9977
<br><dt><code>State</code>
9978
<dd>One of
8737
<dt>‘<samp><span class="samp">Num</span></samp>’<dd>The display number.
8738
8739
<br><dt>‘<samp><span class="samp">Expression</span></samp>’<dd>The displayed expression.
8740
8741
<br><dt>‘<samp><span class="samp">State</span></samp>’<dd>One of
9979
8742
9980
8743
<dl>
9981
<dt><code>enabled</code>
9982
<dd>Normal state.
9983
9984
<br><dt><code>disabled</code>
9985
<dd>Disabled; all details are hidden. Use <code>Show</code> to enable.
9986
9987
<br><dt><code>not active</code>
9988
<dd>Out of scope.
9989
9990
<br><dt><code>deferred</code>
9991
<dd>Will be created as soon as its <code>Scope</code> is reached (see <a href="#Creating%20Single%20Displays">Creating Single Displays</a>).
9992
9993
<br><dt><code>clustered</code>
9994
<dd>Part of a cluster (see <a href="#Clustering">Clustering</a>). Use <code>Undisp =>
9995
Uncluster</code> to uncluster.
9996
9997
<br><dt><code>alias of </code><var>display</var><code></code>
9998
<dd>A suppressed alias of display <var>display</var> (see <a href="#Shared%20Structures">Shared Structures</a>).
8744
<dt>‘<samp><span class="samp">enabled</span></samp>’<dd>Normal state.
8745
8746
<br><dt>‘<samp><span class="samp">disabled</span></samp>’<dd>Disabled; all details are hidden. Use ‘<samp><span class="samp">Show</span></samp>’ to enable.
8747
8748
<br><dt>‘<samp><span class="samp">not active</span></samp>’<dd>Out of scope.
8749
8750
<br><dt>‘<samp><span class="samp">deferred</span></samp>’<dd>Will be created as soon as its ‘<samp><span class="samp">Scope</span></samp>’ is reached (see <a href="#Creating-Single-Displays">Creating Single Displays</a>).
8751
8752
<br><dt>‘<samp><span class="samp">clustered</span></samp>’<dd>Part of a cluster (see <a href="#Clustering">Clustering</a>). Use ‘<samp><span class="samp">Undisp
8753
Uncluster</span></samp>’ to uncluster.
8754
8755
<br><dt>‘<samp><span class="samp">alias of </span><var>display</var></samp>’<dd>A suppressed alias of display <var>display</var> (see <a href="#Shared-Structures">Shared Structures</a>).
9999
8756
</dl>
10000
8757
10001
<br><dt><code>Scope</code>
10002
<dd>The scope in which the display was created. For deferred displays, this
8758
<br><dt>‘<samp><span class="samp">Scope</span></samp>’<dd>The scope in which the display was created. For deferred displays, this
10003
8759
is the scope in which the display will be created.
10004
8760
10005
<br><dt><code>Address</code>
10006
<dd>The address of the displayed expression. Used for resolving aliases
10007
(see <a href="#Shared%20Structures">Shared Structures</a>).
8761
<br><dt>‘<samp><span class="samp">Address</span></samp>’<dd>The address of the displayed expression. Used for resolving aliases
8762
(see <a href="#Shared-Structures">Shared Structures</a>).
10008
8763
</dl>
10009
8764
10010
8765
<div class="node">
10011
8766
<p><hr>
10012
<small class=header>
10013
Node:<a name="Deleting%20Displays">Deleting Displays</a>,
10014
Previous:<a rel="previous" accesskey="p" href="#Editing%20all%20Displays">Editing all Displays</a>,
10015
Up:<a rel="up" accesskey="u" href="#Display%20Basics">Display Basics</a>
8767
<a name="Deleting-Displays"></a>
8768
Previous: <a rel="previous" accesskey="p" href="#Editing-all-Displays">Editing all Displays</a>,
8769
Up: <a rel="up" accesskey="u" href="#Display-Basics">Display Basics</a>
10016
8770
</small>
10017
8771
10018
<br>
8772
10019
8773
</div>
10020
8774
10021
<h5 class="subsubsection">Deleting Displays</h5>
8775
<h5 class="subsubsection">7.3.1.12 Deleting Displays</h5>
10022
8776
10023
<p>To delete a single display, select its title or value and click on the
10024
<code>Undisp</code> button. As an alternative, you can also press <em>mouse
10025
button 3</em> on the display and select the <code>Undisplay</code> item.
8777
<p><a name="index-Display_002c-deleting-972"></a><a name="index-Deleting-displays-973"></a><a name="index-Undisp-974"></a>
8778
To delete a single display, select its title or value and click on the
8779
‘<samp><span class="samp">Undisp</span></samp>’ button. As an alternative, you can also press <em>mouse
8780
button 3</em> on the display and select the ‘<samp><span class="samp">Undisplay</span></samp>’ item.
10026
8781
10027
8782
<p>When a display is deleted, its immediate ancestors and descendants are
10028
8783
automatically selected, so that you can easily delete entire graphs.
10029
8784
10030
<p>If you have selected only part of a display, clicking on the
10031
<code>Undisp</code> button allows you to <em>suppress</em> this part--by
8785
<p><a name="index-Theme_002c-for-suppressing-values-975"></a><a name="index-Values_002c-suppressing-976"></a><a name="index-Display_002c-suppressing-977"></a><a name="index-Suppressing-values-978"></a><a name="index-Suppress-Values-979"></a>If you have selected only part of a display, clicking on the
8786
‘<samp><span class="samp">Undisp</span></samp>’ button allows you to <em>suppress</em> this part—by
10032
8787
applying the <em>Suppress Values</em> theme on the part. You'll be asked
10033
for confirmation first. See <a href="#Using%20Data%20Themes">Using Data Themes</a>, for details.
10034
10035
<br><p>
8788
for confirmation first. See <a href="#Using-Data-Themes">Using Data Themes</a>, for details.
8789
8790
<pre class="sp">
8791
8792
</pre>
10036
8793
<div align="center"><img src="PICS/ddd-suppress.jpg" alt="PICS/ddd-suppress.jpg"></div>
10037
<br><p>
10038
<p>To delete several displays at once, use the <code>Undisp</code> button in the
10039
Display Editor (invoked via <code>Data => Displays</code>). Select any
8794
<pre class="sp">
8795
8796
</pre>
8797
8798
To delete several displays at once, use the ‘<samp><span class="samp">Undisp</span></samp>’ button in the
8799
Display Editor (invoked via ‘<samp><span class="samp">Data Displays</span></samp>’). Select any
10040
8800
number of display items in the usual way and delete them by pressing
10041
<code>Undisp</code>.
8801
‘<samp><span class="samp">Undisp</span></samp>’.
10042
8802
10043
<p>As an alternative, you can also use a <small>DDD</small> command:
8803
<p>As an alternative, you can also use a <acronym>DDD</acronym> command:
10044
8804
10045
8805
<pre class="example"> graph undisplay <var>displays<small class="dots">...</small></var>
10046
</pre>
10047
8806
</pre>
10048
8807
<p>Here, <var>displays<small class="dots">...</small></var> is either
10049
8808
<ul>
10050
8809
<li>a space-separated list of display numbers to disable or enable, or
10053
8812
with this name will be affected.
10054
8813
</ul>
10055
8814
10056
<p>If you are using stacked windows, deleting the last display from the
8815
<p><a name="index-Close-data-window-when-deleting-last-display-980"></a>If you are using stacked windows, deleting the last display from the
10057
8816
data window also automatically closes the data window. (You can change
10058
this via <code>Edit => Preferences => Data => Close
10059
data window when deleting last display</code>.)
8817
this via ‘<samp><span class="samp">Edit Preferences Data Close
8818
data window when deleting last display</span></samp>’.)
10060
8819
10061
<p>If you deleted a display by mistake, use <code>Edit => Undo</code> to
8820
<p><a name="index-Undo-981"></a><a name="index-Undo-deleting-displays-982"></a><a name="index-Deleting-displays_002c-undoing-983"></a>If you deleted a display by mistake, use ‘<samp><span class="samp">Edit Undo</span></samp>’ to
10062
8821
re-create it.
10063
8822
10064
<p>Finally, you can also cut, copy, and paste displays using the
10065
<code>Cut</code>, <code>Copy</code>, and <code>Paste</code> items from the <code>Edit</code>
8823
<p><a name="index-Cutting-displays-984"></a><a name="index-Display_002c-cutting-985"></a><a name="index-Copying-displays-986"></a><a name="index-Display_002c-copying-987"></a><a name="index-Pasting-displays-988"></a><a name="index-Display_002c-pasting-989"></a><a name="index-Clipboard_002c-putting-displays-990"></a><a name="index-Cut-991"></a><a name="index-Copy-992"></a><a name="index-Paste-993"></a>Finally, you can also cut, copy, and paste displays using the
8824
‘<samp><span class="samp">Cut</span></samp>’, ‘<samp><span class="samp">Copy</span></samp>’, and ‘<samp><span class="samp">Paste</span></samp>’ items from the ‘<samp><span class="samp">Edit</span></samp>’
10066
8825
menu. The clipboard holds the <em>commands</em> used to create the
10067
displays; <code>Paste</code> inserts the display commands in the debugger
8826
displays; ‘<samp><span class="samp">Paste</span></samp>’ inserts the display commands in the debugger
10068
8827
console. This allows you to save displays for later usage or to copy
10069
displays across multiple <small>DDD</small> instances.
8828
displays across multiple <acronym>DDD</acronym> instances.
10070
8829
10071
8830
<div class="node">
10072
8831
<p><hr>
10073
<small class=header>
10074
Node:<a name="Arrays">Arrays</a>,
10075
Next:<a rel="next" accesskey="n" href="#Assignment">Assignment</a>,
10076
Previous:<a rel="previous" accesskey="p" href="#Display%20Basics">Display Basics</a>,
10077
Up:<a rel="up" accesskey="u" href="#Displaying%20Values">Displaying Values</a>
8832
<a name="Arrays"></a>
8833
Next: <a rel="next" accesskey="n" href="#Assignment">Assignment</a>,
8834
Previous: <a rel="previous" accesskey="p" href="#Display-Basics">Display Basics</a>,
8835
Up: <a rel="up" accesskey="u" href="#Displaying-Values">Displaying Values</a>
10078
8836
</small>
10079
8837
10080
<br>
8838
10081
8839
</div>
10082
8840
10083
<h4 class="subsection">Arrays</h4>
8841
<h4 class="subsection">7.3.2 Arrays</h4>
10084
8842
10085
<p><small>DDD</small> has some special features that facilitate handling of
8843
<p><acronym>DDD</acronym> has some special features that facilitate handling of
10086
8844
arrays.
10087
8845
10088
8846
<ul class="menu">
10089
<li><a accesskey="1" href="#Array%20Slices">Array Slices</a>: Displaying <var>from</var>..<var>to</var> parts of an array
10090
<li><a accesskey="2" href="#Repeated%20Values">Repeated Values</a>: How repeated values are handled.
10091
<li><a accesskey="3" href="#Arrays%20as%20Tables">Arrays as Tables</a>: Displaying two-dimensional arrays.
8847
<li><a accesskey="1" href="#Array-Slices">Array Slices</a>: Displaying <var>from</var>..<var>to</var> parts of an array
8848
<li><a accesskey="2" href="#Repeated-Values">Repeated Values</a>: How repeated values are handled.
8849
<li><a accesskey="3" href="#Arrays-as-Tables">Arrays as Tables</a>: Displaying two-dimensional arrays.
10092
8850
</ul>
10093
8851
10094
8852
<div class="node">
10095
8853
<p><hr>
10096
<small class=header>
10097
Node:<a name="Array%20Slices">Array Slices</a>,
10098
Next:<a rel="next" accesskey="n" href="#Repeated%20Values">Repeated Values</a>,
10099
Up:<a rel="up" accesskey="u" href="#Arrays">Arrays</a>
8854
<a name="Array-Slices"></a>
8855
Next: <a rel="next" accesskey="n" href="#Repeated-Values">Repeated Values</a>,
8856
Up: <a rel="up" accesskey="u" href="#Arrays">Arrays</a>
10100
8857
</small>
10101
8858
10102
<br>
8859
10103
8860
</div>
10104
8861
10105
<h5 class="subsubsection">Array Slices</h5>
8862
<h5 class="subsubsection">7.3.2.1 Array Slices</h5>
10106
8863
10107
<p>It is often useful to print out several successive objects of the same
8864
<p><a name="index-Array-slices-994"></a><a name="index-Array_002c-artificial-995"></a><a name="index-Artificial-arrays-996"></a>
8865
It is often useful to print out several successive objects of the same
10108
8866
type in memory; a <dfn>slice</dfn> (section) of an array, or an array of
10109
8867
dynamically determined size for which only a pointer exists in the
10110
8868
program.
10111
8869
10112
<p>Using <small>DDD</small>, you can display slices using the
10113
<code></code><var>from</var><code>..</code><var>to</var><code></code> notation (see <a href="#Creating%20Multiple%20Displays">Creating Multiple Displays</a>). But this requires that you already know <var>from</var> and
8870
<p>Using <acronym>DDD</acronym>, you can display slices using the
8871
‘<samp><var>from</var><span class="samp">..</span><var>to</var></samp>’ notation (see <a href="#Creating-Multiple-Displays">Creating Multiple Displays</a>). But this requires that you already know <var>from</var> and
10114
8872
<var>to</var>; it is also inefficient to create several single displays. If
10115
you use <small>GDB</small>, you have yet another alternative.
8873
you use <acronym>GDB</acronym>, you have yet another alternative.
10116
8874
10117
<p>Using <small>GDB</small>, you can display successive objects by referring to a
8875
<p>Using <acronym>GDB</acronym>, you can display successive objects by referring to a
10118
8876
contiguous span of memory as an <dfn>artificial array</dfn>, using the binary
10119
operator <code>@</code>. The left operand of <code>@</code> should be the first
8877
operator ‘<samp><span class="samp">@</span></samp>’. The left operand of ‘<samp><span class="samp">@</span></samp>’ should be the first
10120
8878
element of the desired array and be an individual object. The right
10121
8879
operand should be the desired length of the array. The result is an
10122
8880
array value whose elements are all of the type of the left argument.
10127
8885
<p>Here is an example. If a program says
10128
8886
10129
8887
<pre class="example"> int *array = (int *) malloc (len * sizeof (int));
10130
</pre>
10131
10132
<p>you can print the contents of <code>array</code> with
8888
</pre>
8889
<p class="noindent">you can print the contents of <code>array</code> with
10133
8890
10134
8891
<pre class="example"> print array[0]@len
10135
</pre>
10136
10137
<p>and display the contents with
8892
</pre>
8893
<p class="noindent">and display the contents with
10138
8894
10139
8895
<pre class="example"> graph display array[0]@len
10140
</pre>
10141
8896
</pre>
10142
8897
<p>The general form of displaying an array slice is thus
10143
8898
10144
8899
<pre class="example"> graph display <var>array</var>[<var>first</var>]@<var>nelems</var>
10145
</pre>
10146
10147
<p>where <var>array</var> is the name of the array to display, <var>first</var> is
8900
</pre>
8901
<p class="noindent">where <var>array</var> is the name of the array to display, <var>first</var> is
10148
8902
the index of the first element, and <var>nelems</var> is the number of
10149
8903
elements to display.
10150
8904
10151
<p>The left operand of <code>@</code> must reside in memory. Array values made
10152
with <code>@</code> in this way behave just like other arrays in terms of
8905
<p>The left operand of ‘<samp><span class="samp">@</span></samp>’ must reside in memory. Array values made
8906
with ‘<samp><span class="samp">@</span></samp>’ in this way behave just like other arrays in terms of
10153
8907
subscripting, and are coerced to pointers when used in expressions.
10154
8908
10155
8909
<div class="node">
10156
8910
<p><hr>
10157
<small class=header>
10158
Node:<a name="Repeated%20Values">Repeated Values</a>,
10159
Next:<a rel="next" accesskey="n" href="#Arrays%20as%20Tables">Arrays as Tables</a>,
10160
Previous:<a rel="previous" accesskey="p" href="#Array%20Slices">Array Slices</a>,
10161
Up:<a rel="up" accesskey="u" href="#Arrays">Arrays</a>
8911
<a name="Repeated-Values"></a>
8912
Next: <a rel="next" accesskey="n" href="#Arrays-as-Tables">Arrays as Tables</a>,
8913
Previous: <a rel="previous" accesskey="p" href="#Array-Slices">Array Slices</a>,
8914
Up: <a rel="up" accesskey="u" href="#Arrays">Arrays</a>
10162
8915
</small>
10163
8916
10164
<br>
8917
10165
8918
</div>
10166
8919
10167
<h5 class="subsubsection">Repeated Values</h5>
8920
<h5 class="subsubsection">7.3.2.2 Repeated Values</h5>
10168
8921
10169
<p>Using <small>GDB</small>, an array value that is repeated 10 or more times is displayed
10170
only once. The value is shown with a <code><</code><var>n</var><code>x></code> postfix added,
8922
<p>Using <acronym>GDB</acronym>, an array value that is repeated 10 or more times is displayed
8923
only once. The value is shown with a ‘<samp><span class="samp"><</span><var>n</var><span class="samp">x></span></samp>’ postfix added,
10171
8924
where <var>n</var> is the number of times the value is repeated. Thus, the
10172
display <code>0x0 <30x></code> stands for 30 array elements, each with the
10173
value <code>0x0</code>. This saves a lot of display space, especially with
8925
display ‘<samp><span class="samp">0x0 <30x></span></samp>’ stands for 30 array elements, each with the
8926
value ‘<samp><span class="samp">0x0</span></samp>’. This saves a lot of display space, especially with
10174
8927
homogeneous arrays.
10175
8928
10176
<br><p>
8929
<pre class="sp">
8930
8931
</pre>
10177
8932
<div align="center"><img src="PICS/ddd-repeats.jpg" alt="PICS/ddd-repeats.jpg"></div>
10178
<br><p>
10179
<p>The default <small>GDB</small> threshold for repeated array values is 10. You can
10180
change it via <code>Edit => </code><small>GDB</small><code> Settings => Threshold for
10181
repeated print elements</code>. Setting the threshold to <code>0</code> will cause
10182
<small>GDB</small> (and <small>DDD</small>) to display each array element individually. Be
10183
sure to refresh the data window via <code>Data => Refresh
10184
Displays</code> after a change in <small>GDB</small> settings.
10185
10186
<p>You can also configure <small>DDD</small> to display each array element
8933
<pre class="sp">
8934
8935
</pre>
8936
8937
<a name="index-Threshold-for-repeated-print-elements-997"></a><a name="index-Refresh-Displays-998"></a>The default <acronym>GDB</acronym> threshold for repeated array values is 10. You can
8938
change it via ‘<samp><span class="samp">Edit <acronym>GDB</acronym> Settings Threshold for
8939
repeated print elements</span></samp>’. Setting the threshold to <code>0</code> will cause
8940
<acronym>GDB</acronym> (and <acronym>DDD</acronym>) to display each array element individually. Be
8941
sure to refresh the data window via ‘<samp><span class="samp">Data Refresh
8942
Displays</span></samp>’ after a change in <acronym>GDB</acronym> settings.
8943
8944
<p>You can also configure <acronym>DDD</acronym> to display each array element
10187
8945
individually:
10188
8946
10189
<p>
10190
<table width="100%">
10191
<tr>
10192
<td align="left"><b>expandRepeatedValues</b><i> </i>(<i>class ExpandRepeatedValues</i>)<i>
10193
</i></td>
10194
<td align="right">Resource</td>
10195
</tr>
10196
</table>
10197
<table width="95%" align="center">
10198
<tr><td>
10199
<small>GDB</small> can print repeated array elements as <code></code><var>value</var><code> <repeated
10200
</code><var>n</var><code> times></code>. If <code>expandRepeatedValues</code> is <code>on</code>,
10201
<small>DDD</small> will display <var>n</var> instances of <var>value</var> instead. If
10202
<code>expandRepeatedValues</code> is <code>off</code> (default), <small>DDD</small> will
10203
display <var>value</var> with <code><</code><var>n</var><code>x></code> appended to indicate the
8947
<div class="defun">
8948
— Resource: <b>expandRepeatedValues</b> (<var>class ExpandRepeatedValues</var>)<var><a name="index-expandRepeatedValues-999"></a></var><br>
8949
<blockquote><p><acronym>GDB</acronym> can print repeated array elements as ‘<samp><var>value</var><span class="samp"> <repeated
8950
</span><var>n</var><span class="samp"> times></span></samp>’. If ‘<samp><span class="samp">expandRepeatedValues</span></samp>’ is ‘<samp><span class="samp">on</span></samp>’,
8951
<acronym>DDD</acronym> will display <var>n</var> instances of <var>value</var> instead. If
8952
‘<samp><span class="samp">expandRepeatedValues</span></samp>’ is ‘<samp><span class="samp">off</span></samp>’ (default), <acronym>DDD</acronym> will
8953
display <var>value</var> with ‘<samp><span class="samp"><</span><var>n</var><span class="samp">x></span></samp>’ appended to indicate the
10204
8954
repetition.
10205
</td></tr>
10206
</table>
8955
</p></blockquote></div>
10207
8956
10208
8957
<div class="node">
10209
8958
<p><hr>
10210
<small class=header>
10211
Node:<a name="Arrays%20as%20Tables">Arrays as Tables</a>,
10212
Previous:<a rel="previous" accesskey="p" href="#Repeated%20Values">Repeated Values</a>,
10213
Up:<a rel="up" accesskey="u" href="#Arrays">Arrays</a>
8959
<a name="Arrays-as-Tables"></a>
8960
Previous: <a rel="previous" accesskey="p" href="#Repeated-Values">Repeated Values</a>,
8961
Up: <a rel="up" accesskey="u" href="#Arrays">Arrays</a>
10214
8962
</small>
10215
8963
10216
<br>
8964
10217
8965
</div>
10218
8966
10219
<h5 class="subsubsection">Arrays as Tables</h5>
8967
<h5 class="subsubsection">7.3.2.3 Arrays as Tables</h5>
10220
8968
10221
<p>By default, <small>DDD</small> lays out two-dimensional arrays as tables, such
10222
that all array elements are aligned with each other.<a rel="footnote" href="#fn-27"><sup>27</sup></a> To disable
10223
this feature, unset <code>Edit => Preferences => Data
10224
=> Display Two-Dimensional Arrays as Tables</code>. This is tied to
8969
<p><a name="index-Display-Two_002dDimensional-Arrays-as-Tables-1000"></a>By default, <acronym>DDD</acronym> lays out two-dimensional arrays as tables, such
8970
that all array elements are aligned with each other.<a rel="footnote" href="#fn-27" name="fnd-27"><sup>27</sup></a> To disable
8971
this feature, unset ‘<samp><span class="samp">Edit Preferences Data
8972
Display Two-Dimensional Arrays as Tables</span></samp>’. This is tied to
10225
8973
the following resource:
10226
8974
10227
<p>
10228
<table width="100%">
10229
<tr>
10230
<td align="left"><b>align2dArrays</b><i> </i>(<i>class Align2dArrays</i>)<i>
10231
</i></td>
10232
<td align="right">Resource</td>
10233
</tr>
10234
</table>
10235
<table width="95%" align="center">
10236
<tr><td>
10237
If <code>on</code> (default), <small>DDD</small> lays out two-dimensional arrays
8975
<div class="defun">
8976
— Resource: <b>align2dArrays</b> (<var>class Align2dArrays</var>)<var><a name="index-align2dArrays-1001"></a></var><br>
8977
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), <acronym>DDD</acronym> lays out two-dimensional arrays
10238
8978
as tables, such that all array elements are aligned with each other.
10239
If <code>off</code>, <small>DDD</small> treats a two-dimensional array as an
8979
If ‘<samp><span class="samp">off</span></samp>’, <acronym>DDD</acronym> treats a two-dimensional array as an
10240
8980
array of one-dimensional arrays, each aligned on its own.
10241
</td></tr>
10242
</table>
8981
</p></blockquote></div>
10243
8982
10244
8983
<div class="node">
10245
8984
<p><hr>
10246
<small class=header>
10247
Node:<a name="Assignment">Assignment</a>,
10248
Next:<a rel="next" accesskey="n" href="#Examining%20Structures">Examining Structures</a>,
10249
Previous:<a rel="previous" accesskey="p" href="#Arrays">Arrays</a>,
10250
Up:<a rel="up" accesskey="u" href="#Displaying%20Values">Displaying Values</a>
8985
<a name="Assignment"></a>
8986
Next: <a rel="next" accesskey="n" href="#Examining-Structures">Examining Structures</a>,
8987
Previous: <a rel="previous" accesskey="p" href="#Arrays">Arrays</a>,
8988
Up: <a rel="up" accesskey="u" href="#Displaying-Values">Displaying Values</a>
10251
8989
</small>
10252
8990
10253
<br>
8991
10254
8992
</div>
10255
8993
10256
<h4 class="subsection">Assignment to Variables</h4>
10257
10258
<p>During program execution, you can change the values of arbitrary
10259
variables.<a rel="footnote" href="#fn-28"><sup>28</sup></a>
10260
10261
<p>To change the value of a variable, enter its name in <code>()</code>--for
8994
<h4 class="subsection">7.3.3 Assignment to Variables</h4>
8995
8996
<p><a name="index-Assignment-1002"></a><a name="index-Setting-variables-1003"></a><a name="index-Variables_002c-setting-1004"></a><a name="index-Set-1005"></a>
8997
During program execution, you can change the values of arbitrary
8998
variables.<a rel="footnote" href="#fn-28" name="fnd-28"><sup>28</sup></a>
8999
9000
<p>To change the value of a variable, enter its name in ‘<samp><span class="samp">()</span></samp>’—for
10262
9001
instance, by selecting an occurrence or a display. Then, click on the
10263
<code>Set</code> button. In a dialog, you can edit the variable value at
10264
will; clicking the <code>OK</code> or <code>Apply</code> button commits your change
9002
‘<samp><span class="samp">Set</span></samp>’ button. In a dialog, you can edit the variable value at
9003
will; clicking the ‘<samp><span class="samp">OK</span></samp>’ or ‘<samp><span class="samp">Apply</span></samp>’ button commits your change
10265
9004
and assigns the new value to the variable.
10266
9005
10267
<br><p>
9006
<pre class="sp">
9007
9008
</pre>
10268
9009
<div align="center"><img src="PICS/ddd-set.jpg" alt="PICS/ddd-set.jpg"></div>
10269
<br><p>
10270
<p>To change a displayed value, you can also select <code>Set Value</code> menu
9010
<pre class="sp">
9011
9012
</pre>
9013
9014
<a name="index-Set-Value-1006"></a>To change a displayed value, you can also select ‘<samp><span class="samp">Set Value</span></samp>’ menu
10271
9015
from the data popup menu,
10272
9016
10273
<p>If you made a mistake, you can use <code>Edit => Undo</code> to re-set
9017
<p>If you made a mistake, you can use ‘<samp><span class="samp">Edit Undo</span></samp>’ to re-set
10274
9018
the variable to its previous value.
10275
9019
10276
9020
<div class="node">
10277
9021
<p><hr>
10278
<small class=header>
10279
Node:<a name="Examining%20Structures">Examining Structures</a>,
10280
Next:<a rel="next" accesskey="n" href="#Customizing%20Displays">Customizing Displays</a>,
10281
Previous:<a rel="previous" accesskey="p" href="#Assignment">Assignment</a>,
10282
Up:<a rel="up" accesskey="u" href="#Displaying%20Values">Displaying Values</a>
9022
<a name="Examining-Structures"></a>
9023
Next: <a rel="next" accesskey="n" href="#Customizing-Displays">Customizing Displays</a>,
9024
Previous: <a rel="previous" accesskey="p" href="#Assignment">Assignment</a>,
9025
Up: <a rel="up" accesskey="u" href="#Displaying-Values">Displaying Values</a>
10283
9026
</small>
10284
9027
10285
<br>
9028
10286
9029
</div>
10287
9030
10288
<h4 class="subsection">Examining Structures</h4>
9031
<h4 class="subsection">7.3.4 Examining Structures</h4>
10289
9032
10290
<p>Besides displaying simple values, <small>DDD</small> can also visualize the
10291
<dfn>Dependencies</dfn> between values--especially pointers and other
9033
<p>Besides displaying simple values, <acronym>DDD</acronym> can also visualize the
9034
<dfn>Dependencies</dfn> between values—especially pointers and other
10292
9035
references that make up complex data structures.
10293
9036
10294
9037
<ul class="menu">
10295
<li><a accesskey="1" href="#Dependent%20Values">Dependent Values</a>: Edges from values to values.
10296
<li><a accesskey="2" href="#Dereferencing%20Pointers">Dereferencing Pointers</a>: Examining pointer-based data structures.
10297
<li><a accesskey="3" href="#Shared%20Structures">Shared Structures</a>: Multiple pointers to one display.
10298
<li><a accesskey="4" href="#Display%20Shortcuts">Display Shortcuts</a>: Customize your own menus.
9038
<li><a accesskey="1" href="#Dependent-Values">Dependent Values</a>: Edges from values to values.
9039
<li><a accesskey="2" href="#Dereferencing-Pointers">Dereferencing Pointers</a>: Examining pointer-based data structures.
9040
<li><a accesskey="3" href="#Shared-Structures">Shared Structures</a>: Multiple pointers to one display.
9041
<li><a accesskey="4" href="#Display-Shortcuts">Display Shortcuts</a>: Customize your own menus.
10299
9042
</ul>
10300
9043
10301
9044
<div class="node">
10302
9045
<p><hr>
10303
<small class=header>
10304
Node:<a name="Dependent%20Values">Dependent Values</a>,
10305
Next:<a rel="next" accesskey="n" href="#Dereferencing%20Pointers">Dereferencing Pointers</a>,
10306
Up:<a rel="up" accesskey="u" href="#Examining%20Structures">Examining Structures</a>
9046
<a name="Dependent-Values"></a>
9047
Next: <a rel="next" accesskey="n" href="#Dereferencing-Pointers">Dereferencing Pointers</a>,
9048
Up: <a rel="up" accesskey="u" href="#Examining-Structures">Examining Structures</a>
10307
9049
</small>
10308
9050
10309
<br>
9051
10310
9052
</div>
10311
9053
10312
<h5 class="subsubsection">Displaying Dependent Values</h5>
9054
<h5 class="subsubsection">7.3.4.1 Displaying Dependent Values</h5>
10313
9055
10314
<p>Dependent displays are created from an existing display. The dependency
9056
<p><a name="index-Edge-1007"></a><a name="index-Display_002c-dependent-1008"></a>Dependent displays are created from an existing display. The dependency
10315
9057
is indicated by an <dfn>edge</dfn> leading from the originating display to
10316
9058
the dependent display.
10317
9059
10318
9060
<p>To create a dependent display, select the originating display or display
10319
part and enter the dependent expression in the <code>():</code> argument
10320
field. Then click on the <code>Display</code> button.
9061
part and enter the dependent expression in the ‘<samp><span class="samp">():</span></samp>’ argument
9062
field. Then click on the ‘<samp><span class="samp">Display</span></samp>’ button.
10321
9063
10322
9064
<p>Using dependent displays, you can investigate the data structure of a
10323
9065
tree for example and lay it out according to your intuitive image of the
10324
9066
tree data structure.
10325
9067
10326
<p>By default, <small>DDD</small> does not recognize shared data structures
9068
<p>By default, <acronym>DDD</acronym> does not recognize shared data structures
10327
9069
(i.e. a data object referenced by multiple other data objects).
10328
See <a href="#Shared%20Structures">Shared Structures</a>, for details on how to examine such structures.
9070
See <a href="#Shared-Structures">Shared Structures</a>, for details on how to examine such structures.
10329
9071
10330
9072
<div class="node">
10331
9073
<p><hr>
10332
<small class=header>
10333
Node:<a name="Dereferencing%20Pointers">Dereferencing Pointers</a>,
10334
Next:<a rel="next" accesskey="n" href="#Shared%20Structures">Shared Structures</a>,
10335
Previous:<a rel="previous" accesskey="p" href="#Dependent%20Values">Dependent Values</a>,
10336
Up:<a rel="up" accesskey="u" href="#Examining%20Structures">Examining Structures</a>
9074
<a name="Dereferencing-Pointers"></a>
9075
Next: <a rel="next" accesskey="n" href="#Shared-Structures">Shared Structures</a>,
9076
Previous: <a rel="previous" accesskey="p" href="#Dependent-Values">Dependent Values</a>,
9077
Up: <a rel="up" accesskey="u" href="#Examining-Structures">Examining Structures</a>
10337
9078
</small>
10338
9079
10339
<br>
9080
10340
9081
</div>
10341
9082
10342
<h5 class="subsubsection">Dereferencing Pointers</h5>
9083
<h5 class="subsubsection">7.3.4.2 Dereferencing Pointers</h5>
10343
9084
10344
<p>There are special shortcuts for creating dependent displays showing the
9085
<p><a name="index-Dereferencing-1009"></a><a name="index-Pointers_002c-dereferencing-1010"></a>
9086
There are special shortcuts for creating dependent displays showing the
10345
9087
value of a dereferenced pointer. This allows for rapid examination of
10346
9088
pointer-based data structures.
10347
9089
10348
<p>To dereference a pointer, select the originating pointer value or name
10349
and click on the <code>Disp *</code> button. A new display showing the
9090
<p><a name="index-Disp-_002a-1011"></a>To dereference a pointer, select the originating pointer value or name
9091
and click on the ‘<samp><span class="samp">Disp *</span></samp>’ button. A new display showing the
10350
9092
dereferenced pointer value is created.
10351
9093
10352
<p>As a faster alternative, you can also press <em>mouse button 3</em> on the
10353
originating pointer value or name and select the <code>Display *</code> menu
9094
<p><a name="index-Display-_002a-1012"></a>As a faster alternative, you can also press <em>mouse button 3</em> on the
9095
originating pointer value or name and select the ‘<samp><span class="samp">Display *</span></samp>’ menu
10354
9096
item.
10355
9097
10356
9098
<p>As an even faster alternative, you can also double-click <em>mouse
10357
9099
button 1</em> on the originating pointer value or name. If you press
10358
9100
<Ctrl> while double-clicking, the display will be dereferenced
10359
<em>in place</em>-that is, it will be replaced by the dereferenced
9101
<em>in place</em>–that is, it will be replaced by the dereferenced
10360
9102
display.
10361
9103
10362
<p>The <code>Display *()</code> function is also accessible by pressing and
10363
holding the <code>Display</code> button.
9104
<p><a name="index-Display-_002a_0028_0029-1013"></a>The ‘<samp><span class="samp">Display *()</span></samp>’ function is also accessible by pressing and
9105
holding the ‘<samp><span class="samp">Display</span></samp>’ button.
10364
9106
10365
9107
<div class="node">
10366
9108
<p><hr>
10367
<small class=header>
10368
Node:<a name="Shared%20Structures">Shared Structures</a>,
10369
Next:<a rel="next" accesskey="n" href="#Display%20Shortcuts">Display Shortcuts</a>,
10370
Previous:<a rel="previous" accesskey="p" href="#Dereferencing%20Pointers">Dereferencing Pointers</a>,
10371
Up:<a rel="up" accesskey="u" href="#Examining%20Structures">Examining Structures</a>
9109
<a name="Shared-Structures"></a>
9110
Next: <a rel="next" accesskey="n" href="#Display-Shortcuts">Display Shortcuts</a>,
9111
Previous: <a rel="previous" accesskey="p" href="#Dereferencing-Pointers">Dereferencing Pointers</a>,
9112
Up: <a rel="up" accesskey="u" href="#Examining-Structures">Examining Structures</a>
10372
9113
</small>
10373
9114
10374
<br>
9115
10375
9116
</div>
10376
9117
10377
<h5 class="subsubsection">Shared Structures</h5>
9118
<h5 class="subsubsection">7.3.4.3 Shared Structures</h5>
10378
9119
10379
<p>By default, <small>DDD</small> does not recognize shared data structures--that
9120
<p>By default, <acronym>DDD</acronym> does not recognize shared data structures—that
10380
9121
is, a data object referenced by multiple other data objects. For
10381
instance, if two pointers <code>p1</code> and <code>p2</code> point at the same data
10382
object <code>d</code>, the data displays <code>d</code>, <code>*p1</code>, and <code>*p2</code>
9122
instance, if two pointers ‘<samp><span class="samp">p1</span></samp>’ and ‘<samp><span class="samp">p2</span></samp>’ point at the same data
9123
object ‘<samp><span class="samp">d</span></samp>’, the data displays ‘<samp><span class="samp">d</span></samp>’, ‘<samp><span class="samp">*p1</span></samp>’, and ‘<samp><span class="samp">*p2</span></samp>’
10383
9124
will be separate, although they denote the same object.
10384
9125
10385
<p><small>DDD</small> provides a special mode which makes it detect these
10386
situations. <small>DDD</small> recognizes if two or more data displays are
9126
<p><a name="index-Detect-Aliases-1014"></a><a name="index-Aliases_002c-detecting-1015"></a><a name="index-Shared-structures_002c-detecting-1016"></a><acronym>DDD</acronym> provides a special mode which makes it detect these
9127
situations. <acronym>DDD</acronym> recognizes if two or more data displays are
10387
9128
stored at the same physical address, and if this is so, merges all these
10388
9129
<dfn>aliases</dfn> into one single data display, the <em>original data
10389
9130
display</em>. This mode is called <em>Alias Detection</em>; it is enabled via
10390
<code>Data => Detect Aliases</code>.
9131
‘<samp><span class="samp">Data Detect Aliases</span></samp>’.
10391
9132
10392
<p>When alias detection is enabled, <small>DDD</small> inquires the memory
9133
<p>When alias detection is enabled, <acronym>DDD</acronym> inquires the memory
10393
9134
location (the <em>address</em>) of each data display after each program
10394
9135
step. If two displays have the same address, they are merged into one.
10395
9136
More specifically, only the one which has least recently changed remains
10397
9138
<em>suppressed</em>, i.e. completely hidden. The edges leading to the
10398
9139
aliases are replaced by edges leading to the original data display.
10399
9140
10400
<p>An edge created by alias detection is somewhat special: rather than
9141
<p><a name="index-Edge-hint-1017"></a>An edge created by alias detection is somewhat special: rather than
10401
9142
connecting two displays directly, it goes through an <dfn>edge hint</dfn>,
10402
9143
describing an arc connecting the two displays and the edge hint.
10403
9144
10404
9145
<p>Each edge hint is a placeholder for a suppressed alias; selecting an
10405
9146
edge hint is equivalent to selecting the alias. This way, you can
10406
9147
easily delete display aliases by simply selecting the edge hint and
10407
clicking on <code>Undisp</code>.
10408
10409
<br><p>
9148
clicking on ‘<samp><span class="samp">Undisp</span></samp>’.
9149
9150
<pre class="sp">
9151
9152
</pre>
10410
9153
<div align="center"><img src="PICS/ddd-aliases.jpg" alt="PICS/ddd-aliases.jpg"></div>
10411
<br><p>
10412
<p>To access suppressed display aliases, you can also use the Display
9154
<pre class="sp">
9155
9156
</pre>
9157
9158
To access suppressed display aliases, you can also use the Display
10413
9159
Editor. Suppressed displays are listed in the Display Editor as
10414
9160
<em>aliases</em> of the original data display. Via the Display Editor,
10415
9161
you can select, change, and delete suppressed displays.
10432
9178
a means to determine the address of an arbitrary data object.
10433
9179
Currently, only C, C++, and Java are supported.
10434
9180
10435
<li>Some inferior debuggers (for instance, SunOS <small>DBX</small>) produce incorrect
9181
<li>Some inferior debuggers (for instance, SunOS <acronym>DBX</acronym>) produce incorrect
10436
9182
output for address expressions. Given a pointer <var>p</var>, you may verify
10437
9183
the correct function of your inferior debugger by comparing the values
10438
of <var>p</var> and <code>&</code><var>p</var><code></code> (unless <var>p</var> actually points to
9184
of <var>p</var> and ‘<samp><span class="samp">&</span><var>p</var></samp>’ (unless <var>p</var> actually points to
10439
9185
itself). You can also examine the data display addresses, as shown in
10440
9186
the Display Editor.
10441
9187
10442
<li>Alias detection slows down <small>DDD</small> slightly, which is why you can turn
10443
it off. You may consider to enable it only at need--for
10444
instance, while examining some complex data structure--and disable it
9188
<li>Alias detection slows down <acronym>DDD</acronym> slightly, which is why you can turn
9189
it off. You may consider to enable it only at need—for
9190
instance, while examining some complex data structure—and disable it
10445
9191
while examining control flow (i.e., stepping through your program).
10446
<small>DDD</small> will automatically restore edges and data displays when
9192
<acronym>DDD</acronym> will automatically restore edges and data displays when
10447
9193
switching modes.
10448
9194
</ul>
10449
9195
10450
9196
<p>Alias detection is controlled by the following resources:
10451
9197
10452
<p>
10453
<table width="100%">
10454
<tr>
10455
<td align="left"><b>deleteAliasDisplays</b><i> </i>(<i>class DeleteAliasDisplays</i>)<i>
10456
</i></td>
10457
<td align="right">Resource</td>
10458
</tr>
10459
</table>
10460
<table width="95%" align="center">
10461
<tr><td>
10462
If this is <code>on</code> (default), the <code>Undisplay ()</code> button also
10463
deletes all aliases of the selected displays. If this is <code>off</code>,
9198
<div class="defun">
9199
— Resource: <b>deleteAliasDisplays</b> (<var>class DeleteAliasDisplays</var>)<var><a name="index-deleteAliasDisplays-1018"></a></var><br>
9200
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’ (default), the ‘<samp><span class="samp">Undisplay ()</span></samp>’ button also
9201
deletes all aliases of the selected displays. If this is ‘<samp><span class="samp">off</span></samp>’,
10464
9202
only the selected displays are deleted; the aliases remain, and one of
10465
9203
the aliases will be unsuppressed.
10466
</td></tr>
10467
</table>
9204
</p></blockquote></div>
10468
9205
10469
<p>
10470
<table width="100%">
10471
<tr>
10472
<td align="left"><b>detectAliases</b><i> </i>(<i>class DetectAliases</i>)<i>
10473
</i></td>
10474
<td align="right">Resource</td>
10475
</tr>
10476
</table>
10477
<table width="95%" align="center">
10478
<tr><td>
10479
If <code>on</code> (default), <small>DDD</small> attempts to recognize shared data structures.
10480
If <code>off</code>, shared data structures are not
9206
<div class="defun">
9207
— Resource: <b>detectAliases</b> (<var>class DetectAliases</var>)<var><a name="index-detectAliases-1019"></a></var><br>
9208
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), <acronym>DDD</acronym> attempts to recognize shared data structures.
9209
If ‘<samp><span class="samp">off</span></samp>’, shared data structures are not
10481
9210
recognized.
10482
</td></tr>
10483
</table>
9211
</p></blockquote></div>
10484
9212
10485
<p>
10486
<table width="100%">
10487
<tr>
10488
<td align="left"><b>typedAliases</b><i> </i>(<i>class TypedAliases</i>)<i>
10489
</i></td>
10490
<td align="right">Resource</td>
10491
</tr>
10492
</table>
10493
<table width="95%" align="center">
10494
<tr><td>
10495
If <code>on</code> (default), <small>DDD</small> requires structural equivalence in
10496
order to recognize shared data structures. If this is <code>off</code>, two
9213
<div class="defun">
9214
— Resource: <b>typedAliases</b> (<var>class TypedAliases</var>)<var><a name="index-typedAliases-1020"></a></var><br>
9215
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), <acronym>DDD</acronym> requires structural equivalence in
9216
order to recognize shared data structures. If this is ‘<samp><span class="samp">off</span></samp>’, two
10497
9217
displays at the same address are considered aliases, regardless of their
10498
9218
structure.
10499
</td></tr>
10500
</table>
9219
</p></blockquote></div>
10501
9220
10502
9221
<div class="node">
10503
9222
<p><hr>
10504
<small class=header>
10505
Node:<a name="Display%20Shortcuts">Display Shortcuts</a>,
10506
Previous:<a rel="previous" accesskey="p" href="#Shared%20Structures">Shared Structures</a>,
10507
Up:<a rel="up" accesskey="u" href="#Examining%20Structures">Examining Structures</a>
9223
<a name="Display-Shortcuts"></a>
9224
Previous: <a rel="previous" accesskey="p" href="#Shared-Structures">Shared Structures</a>,
9225
Up: <a rel="up" accesskey="u" href="#Examining-Structures">Examining Structures</a>
10508
9226
</small>
10509
9227
10510
<br>
9228
10511
9229
</div>
10512
9230
10513
<h5 class="subsubsection">Display Shortcuts</h5>
9231
<h5 class="subsubsection">7.3.4.4 Display Shortcuts</h5>
10514
9232
10515
<p><small>DDD</small> maintains a <em>shortcut menu</em> of frequently used display
9233
<p><acronym>DDD</acronym> maintains a <em>shortcut menu</em> of frequently used display
10516
9234
expressions. This menu is activated
10517
9235
10518
9236
<ul>
10519
<li>by pressing and holding the <code>Display</code> button, or
9237
<li>by pressing and holding the ‘<samp><span class="samp">Display</span></samp>’ button, or
10520
9238
10521
9239
<li>by pressing <em>mouse button 3</em> on some display and selecting
10522
<code>New Display</code>, or
9240
‘<samp><span class="samp">New Display</span></samp>’, or
10523
9241
10524
9242
<li>by pressing <Shift> and <em>mouse button 3</em> on some display.
10525
9243
</ul>
10526
9244
10527
9245
<p>By default, the shortcut menu contains frequently used base conversions.
10528
9246
10529
<p>The <code>Other</code> entry in the shortcut menu lets you create a new
9247
<p><a name="index-Other-1021"></a>The ‘<samp><span class="samp">Other</span></samp>’ entry in the shortcut menu lets you create a new
10530
9248
display that <em>extends</em> the shortcut menu.
10531
9249
10532
<p>As an example, assume you have selected a display named <code>date_ptr</code>.
10533
Selecting <code>Display => Other</code> pops up a dialog that allows
10534
you to enter a new expression to be displayed--for instance, you can
10535
cast the display <code>date_ptr</code> to a new display <code>(char
10536
*)date_ptr</code>. If the <code>Include in New Display Menu</code> toggle
9250
<p>As an example, assume you have selected a display named ‘<samp><span class="samp">date_ptr</span></samp>’.
9251
Selecting ‘<samp><span class="samp">Display Other</span></samp>’ pops up a dialog that allows
9252
you to enter a new expression to be displayed—for instance, you can
9253
cast the display ‘<samp><span class="samp">date_ptr</span></samp>’ to a new display ‘<samp><span class="samp">(char
9254
*)date_ptr</span></samp>’. If the ‘<samp><span class="samp">Include in ‘</span><samp><span class="samp">New Display</span></samp><span class="samp">’ Menu</span></samp>’ toggle
10537
9255
was activated, the shortcut menu will then contain a new entry
10538
<code>Display (char *)()</code> that will cast <em>any</em> selected display
10539
<var>display</var> to <code>(char *)</code><var>display</var><code></code>. Such shortcuts can save
9256
‘<samp><span class="samp">Display (char *)()</span></samp>’ that will cast <em>any</em> selected display
9257
<var>display</var> to ‘<samp><span class="samp">(char *)</span><var>display</var></samp>’. Such shortcuts can save
10540
9258
you a lot of time when examining complex data structures.
10541
9259
10542
<br><p>
9260
<pre class="sp">
9261
9262
</pre>
10543
9263
<div align="center"><img src="PICS/ddd-shortcuts.jpg" alt="PICS/ddd-shortcuts.jpg"></div>
10544
<br><p>
10545
<p>You can edit the contents of the <code>New Display</code> menu by selecting
10546
its <code>Edit Menu</code> item. This pops up the <em>Shortcut Editor</em>
9264
<pre class="sp">
9265
9266
</pre>
9267
9268
<a name="index-Edit-Menu-1022"></a>You can edit the contents of the ‘<samp><span class="samp">New Display</span></samp>’ menu by selecting
9269
its ‘<samp><span class="samp">Edit Menu</span></samp>’ item. This pops up the <em>Shortcut Editor</em>
10547
9270
containing all shortcut expressions, which you can edit at leisure.
10548
9271
Each line contains the expression for exactly one menu item. Clicking
10549
on <code>Apply</code> re-creates the <code>New Display</code> menu from the text.
10550
If the text is empty, the <code>New Display</code> menu will be empty, too.
10551
10552
<br><p>
9272
on ‘<samp><span class="samp">Apply</span></samp>’ re-creates the ‘<samp><span class="samp">New Display</span></samp>’ menu from the text.
9273
If the text is empty, the ‘<samp><span class="samp">New Display</span></samp>’ menu will be empty, too.
9274
9275
<pre class="sp">
9276
9277
</pre>
10553
9278
<div align="center"><img src="PICS/ddd-shortcut-editor.jpg" alt="PICS/ddd-shortcut-editor.jpg"></div>
10554
<br><p>
10555
<p><small>DDD</small> also allows you to specify individual labels for
9279
<pre class="sp">
9280
9281
</pre>
9282
9283
<acronym>DDD</acronym> also allows you to specify individual labels for
10556
9284
user-defined buttons. You can write such a label after the expression,
10557
separated by <code>//</code>. This feature is used in the default contents of
10558
the <small>GDB</small> <code>New Display</code> menu, where each of the base conversions has
9285
separated by ‘<samp><span class="samp">//</span></samp>’. This feature is used in the default contents of
9286
the <acronym>GDB</acronym> ‘<samp><span class="samp">New Display</span></samp>’ menu, where each of the base conversions has
10559
9287
a label:
10560
9288
10561
9289
<pre class="example"> /t () // Convert to Bin
10562
9290
/d () // Convert to Dec
10563
9291
/x () // Convert to Hex
10564
9292
/o () // Convert to Oct
10565
</pre>
10566
10567
<p>Feel free to add other conversions here. <small>DDD</small> supports up to 20
10568
<code>New Display</code> menu items.
9293
</pre>
9294
<p><a name="index-New-Display-1023"></a>Feel free to add other conversions here. <acronym>DDD</acronym> supports up to 20
9295
‘<samp><span class="samp">New Display</span></samp>’ menu items.
10569
9296
10570
9297
<p>The shortcut menu is controlled by the following resources:
10571
9298
10572
<p>
10573
<table width="100%">
10574
<tr>
10575
<td align="left"><b>dbxDisplayShortcuts</b><i> </i>(<i>class DisplayShortcuts</i>)<i>
10576
</i></td>
10577
<td align="right">Resource</td>
10578
</tr>
10579
</table>
10580
<table width="95%" align="center">
10581
<tr><td>
10582
A newline-separated list of display expressions to be included in the
10583
<code>New Display</code> menu for <small>DBX</small>.
9299
<div class="defun">
9300
— Resource: <b>dbxDisplayShortcuts</b> (<var>class DisplayShortcuts</var>)<var><a name="index-dbxDisplayShortcuts-1024"></a></var><br>
9301
<blockquote><p>A newline-separated list of display expressions to be included in the
9302
‘<samp><span class="samp">New Display</span></samp>’ menu for <acronym>DBX</acronym>.
10584
9303
10585
<p>If a line contains a label delimiter<a rel="footnote" href="#fn-29"><sup>29</sup></a>, the string before the delimiter is used as
9304
<p>If a line contains a label delimiter<a rel="footnote" href="#fn-29" name="fnd-29"><sup>29</sup></a>, the string before the delimiter is used as
10586
9305
<var>expression</var>, and the string after the delimiter is used as label.
10587
Otherwise, the label is <code>Display </code><var>expression</var><code></code>. Upon
10588
activation, the string <code>()</code> in <var>expression</var> is replaced by the
9306
Otherwise, the label is ‘<samp><span class="samp">Display </span><var>expression</var></samp>’. Upon
9307
activation, the string ‘<samp><span class="samp">()</span></samp>’ in <var>expression</var> is replaced by the
10589
9308
name of the currently selected display.
10590
</td></tr>
10591
</table>
10592
10593
<p>
10594
<table width="100%">
10595
<tr>
10596
<td align="left"><b>gdbDisplayShortcuts</b><i> </i>(<i>class DisplayShortcuts</i>)<i>
10597
</i></td>
10598
<td align="right">Resource</td>
10599
</tr>
10600
</table>
10601
<table width="95%" align="center">
10602
<tr><td>
10603
A newline-separated list of display expressions to be included in the
10604
<code>New Display</code> menu for <small>GDB</small>. See the description of
10605
<code>dbxDisplayShortcuts</code>, above.
10606
</td></tr>
10607
</table>
10608
10609
<p>
10610
<table width="100%">
10611
<tr>
10612
<td align="left"><b>jdbDisplayShortcuts</b><i> </i>(<i>class DisplayShortcuts</i>)<i>
10613
</i></td>
10614
<td align="right">Resource</td>
10615
</tr>
10616
</table>
10617
<table width="95%" align="center">
10618
<tr><td>
10619
A newline-separated list of display expressions to be included in the
10620
<code>New Display</code> menu for <small>JDB</small>. See the description of
10621
<code>dbxDisplayShortcuts</code>, above.
10622
</td></tr>
10623
</table>
10624
10625
<p>
10626
<table width="100%">
10627
<tr>
10628
<td align="left"><b>perlDisplayShortcuts</b><i> </i>(<i>class DisplayShortcuts</i>)<i>
10629
</i></td>
10630
<td align="right">Resource</td>
10631
</tr>
10632
</table>
10633
<table width="95%" align="center">
10634
<tr><td>
10635
A newline-separated list of display expressions to be included in the
10636
<code>New Display</code> menu for Perl. See the description of
10637
<code>dbxDisplayShortcuts</code>, above.
10638
</td></tr>
10639
</table>
10640
10641
<p>
10642
<table width="100%">
10643
<tr>
10644
<td align="left"><b>bashDisplayShortcuts</b><i> </i>(<i>class DisplayShortcuts</i>)<i>
10645
</i></td>
10646
<td align="right">Resource</td>
10647
</tr>
10648
</table>
10649
<table width="95%" align="center">
10650
<tr><td>
10651
A newline-separated list of display expressions to be included in the
10652
<code>New Display</code> menu for Bash. See the description of
10653
<code>dbxDisplayShortcuts</code>, above.
10654
</td></tr>
10655
</table>
10656
10657
<p>
10658
<table width="100%">
10659
<tr>
10660
<td align="left"><b>pydbDisplayShortcuts</b><i> </i>(<i>class DisplayShortcuts</i>)<i>
10661
</i></td>
10662
<td align="right">Resource</td>
10663
</tr>
10664
</table>
10665
<table width="95%" align="center">
10666
<tr><td>
10667
A newline-separated list of display expressions to be included in the
10668
<code>New Display</code> menu for <small>PYDB</small>. See the description of
10669
<code>dbxDisplayShortcuts</code>, above.
10670
</td></tr>
10671
</table>
10672
10673
<p>
10674
<table width="100%">
10675
<tr>
10676
<td align="left"><b>xdbDisplayShortcuts</b><i> </i>(<i>class DisplayShortcuts</i>)<i>
10677
</i></td>
10678
<td align="right">Resource</td>
10679
</tr>
10680
</table>
10681
<table width="95%" align="center">
10682
<tr><td>
10683
A newline-separated list of display expressions to be included in the
10684
<code>New Display</code> menu for <small>XDB</small>. See the description of
10685
<code>dbxDisplayShortcuts</code>, above.
10686
</td></tr>
10687
</table>
9309
</p></blockquote></div>
9310
9311
<div class="defun">
9312
— Resource: <b>gdbDisplayShortcuts</b> (<var>class DisplayShortcuts</var>)<var><a name="index-gdbDisplayShortcuts-1025"></a></var><br>
9313
<blockquote><p>A newline-separated list of display expressions to be included in the
9314
‘<samp><span class="samp">New Display</span></samp>’ menu for <acronym>GDB</acronym>. See the description of
9315
‘<samp><span class="samp">dbxDisplayShortcuts</span></samp>’, above.
9316
</p></blockquote></div>
9317
9318
<div class="defun">
9319
— Resource: <b>jdbDisplayShortcuts</b> (<var>class DisplayShortcuts</var>)<var><a name="index-jdbDisplayShortcuts-1026"></a></var><br>
9320
<blockquote><p>A newline-separated list of display expressions to be included in the
9321
‘<samp><span class="samp">New Display</span></samp>’ menu for <acronym>JDB</acronym>. See the description of
9322
‘<samp><span class="samp">dbxDisplayShortcuts</span></samp>’, above.
9323
</p></blockquote></div>
9324
9325
<div class="defun">
9326
— Resource: <b>perlDisplayShortcuts</b> (<var>class DisplayShortcuts</var>)<var><a name="index-perlDisplayShortcuts-1027"></a></var><br>
9327
<blockquote><p>A newline-separated list of display expressions to be included in the
9328
‘<samp><span class="samp">New Display</span></samp>’ menu for Perl. See the description of
9329
‘<samp><span class="samp">dbxDisplayShortcuts</span></samp>’, above.
9330
</p></blockquote></div>
9331
9332
<div class="defun">
9333
— Resource: <b>bashDisplayShortcuts</b> (<var>class DisplayShortcuts</var>)<var><a name="index-bashDisplayShortcuts-1028"></a></var><br>
9334
<blockquote><p>A newline-separated list of display expressions to be included in the
9335
‘<samp><span class="samp">New Display</span></samp>’ menu for Bash. See the description of
9336
‘<samp><span class="samp">dbxDisplayShortcuts</span></samp>’, above.
9337
</p></blockquote></div>
9338
9339
<div class="defun">
9340
— Resource: <b>pydbDisplayShortcuts</b> (<var>class DisplayShortcuts</var>)<var><a name="index-pydbDisplayShortcuts-1029"></a></var><br>
9341
<blockquote><p>A newline-separated list of display expressions to be included in the
9342
‘<samp><span class="samp">New Display</span></samp>’ menu for <code>pydb</code>. See the description of
9343
‘<samp><span class="samp">dbxDisplayShortcuts</span></samp>’, above.
9344
</p></blockquote></div>
9345
9346
<div class="defun">
9347
— Resource: <b>xdbDisplayShortcuts</b> (<var>class DisplayShortcuts</var>)<var><a name="index-xdbDisplayShortcuts-1030"></a></var><br>
9348
<blockquote><p>A newline-separated list of display expressions to be included in the
9349
‘<samp><span class="samp">New Display</span></samp>’ menu for <acronym>XDB</acronym>. See the description of
9350
‘<samp><span class="samp">dbxDisplayShortcuts</span></samp>’, above.
9351
</p></blockquote></div>
10688
9352
10689
9353
<div class="node">
10690
9354
<p><hr>
10691
<small class=header>
10692
Node:<a name="Customizing%20Displays">Customizing Displays</a>,
10693
Next:<a rel="next" accesskey="n" href="#Layouting%20the%20Graph">Layouting the Graph</a>,
10694
Previous:<a rel="previous" accesskey="p" href="#Examining%20Structures">Examining Structures</a>,
10695
Up:<a rel="up" accesskey="u" href="#Displaying%20Values">Displaying Values</a>
9355
<a name="Customizing-Displays"></a>
9356
Next: <a rel="next" accesskey="n" href="#Layouting-the-Graph">Layouting the Graph</a>,
9357
Previous: <a rel="previous" accesskey="p" href="#Examining-Structures">Examining Structures</a>,
9358
Up: <a rel="up" accesskey="u" href="#Displaying-Values">Displaying Values</a>
10696
9359
</small>
10697
9360
10698
<br>
9361
10699
9362
</div>
10700
9363
10701
<h4 class="subsection">Customizing Displays</h4>
9364
<h4 class="subsection">7.3.5 Customizing Displays</h4>
9365
9366
<p><a name="index-Display_002c-customizing-1031"></a>
10702
9367
10703
9368
<ul class="menu">
10704
<li><a accesskey="1" href="#Using%20Data%20Themes">Using Data Themes</a>:
10705
<li><a accesskey="2" href="#Applying%20Data%20Themes%20to%20Several%20Values">Applying Data Themes to Several Values</a>:
10706
<li><a accesskey="3" href="#Editing%20Themes">Editing Themes</a>:
10707
<li><a accesskey="4" href="#Writing%20Data%20Themes">Writing Data Themes</a>:
10708
<li><a accesskey="5" href="#Display%20Resources">Display Resources</a>:
10709
<li><a accesskey="6" href="#VSL%20Resources">VSL Resources</a>:
9369
<li><a accesskey="1" href="#Using-Data-Themes">Using Data Themes</a>
9370
<li><a accesskey="2" href="#Applying-Data-Themes-to-Several-Values">Applying Data Themes to Several Values</a>
9371
<li><a accesskey="3" href="#Editing-Themes">Editing Themes</a>
9372
<li><a accesskey="4" href="#Writing-Data-Themes">Writing Data Themes</a>
9373
<li><a accesskey="5" href="#Display-Resources">Display Resources</a>
9374
<li><a accesskey="6" href="#VSL-Resources">VSL Resources</a>
10710
9375
</ul>
10711
9376
10712
9377
<div class="node">
10713
9378
<p><hr>
10714
<small class=header>
10715
Node:<a name="Using%20Data%20Themes">Using Data Themes</a>,
10716
Next:<a rel="next" accesskey="n" href="#Applying%20Data%20Themes%20to%20Several%20Values">Applying Data Themes to Several Values</a>,
10717
Up:<a rel="up" accesskey="u" href="#Customizing%20Displays">Customizing Displays</a>
9379
<a name="Using-Data-Themes"></a>
9380
Next: <a rel="next" accesskey="n" href="#Applying-Data-Themes-to-Several-Values">Applying Data Themes to Several Values</a>,
9381
Up: <a rel="up" accesskey="u" href="#Customizing-Displays">Customizing Displays</a>
10718
9382
</small>
10719
9383
10720
<br>
9384
10721
9385
</div>
10722
9386
10723
<h5 class="subsubsection">Using Data Themes</h5>
9387
<h5 class="subsubsection">7.3.5.1 Using Data Themes</h5>
10724
9388
10725
<p><small>DDD</small> provides a simple method to customize displays. <small>DDD</small> comes
9389
<p><a name="index-Theme_002c-Data-1032"></a><a name="index-Data-Theme-1033"></a>
9390
<acronym>DDD</acronym> provides a simple method to customize displays. <acronym>DDD</acronym> comes
10726
9391
with a number of <em>visual modifiers</em>, called <em>data themes</em>.
10727
9392
10728
9393
<p>Each theme modifies a particular aspect of a data display. It can be
10729
9394
applied to individual displays or to a number of displays. The themes
10730
installed with <small>DDD</small> include:
9395
installed with <acronym>DDD</acronym> include:
10731
9396
10732
9397
<dl>
10733
<dt><code>Small Titles</code>
10734
<dd>Apply this theme to show display titles in a smaller font.
10735
<br><dt><code>Small Values</code>
10736
<dd>Apply this theme to display values in a smaller font.
10737
<br><dt><code>Tiny Values</code>
10738
<dd>Apply this theme to display values in a tiny font.
10739
<br><dt><code>Suppress Values</code>
10740
<dd>Apply this theme to display values not at all.
10741
</dl>
9398
<dt>‘<samp><span class="samp">Small Titles</span></samp>’<dd><a name="index-Small-Titles-1034"></a>If enabled, display titles in a smaller font.
9399
<br><dt>‘<samp><span class="samp">Small Values</span></samp>’<dd><a name="index-Small-Values-1035"></a>Apply this theme to display values in a smaller font.
9400
<br><dt>‘<samp><span class="samp">Tiny Values</span></samp>’<dd><a name="index-Tiny-Values-1036"></a>If enabled, display values in a tiny font.
9401
This could be combined with a pattern like <code>*\[*\]</code> to make
9402
all array members tiny.
9403
Apply this theme to display values in a tiny font.
9404
<br><dt>‘<samp><span class="samp">Suppress Values</span></samp>’<dd><a name="index-Suppress-Values-1037"></a>If enabled, the given value will be suppressed. This should be
9405
combined with a pattern like <code>*->X</code> to suppress all members named
9406
`X'. Apply this theme to display values not at all.
9407
<br><dt>‘<samp><span class="samp">Red Background</span></samp>’<dd><a name="index-Red-Background-1038"></a>Use this with a self-defined button
9408
associated with the command <code>graph apply red.vsl "()"</code>
9409
<br><dt>‘<samp><span class="samp">Red nil pointers</span></samp>’<dd><a name="index-Red-Background-1039"></a>If enabled, show nil pointers in red.
9410
<br><dt>‘<samp><span class="samp">Green background</span></samp>’<dd><a name="index-Green-background-1040"></a>Use this with a self-defined button associated with the command
9411
<code>graph apply green.vsl "()"</code>.
9412
<br><dt>‘<samp><span class="samp">Intel x86 flag bits and registers</span></samp>’<dd><a name="index-Intel-x86-flab-gits-and-registers-1041"></a>To use this theme, set up some data buttons like this:
9413
9414
<pre class="example"> Ddd*dataButtons: \
9415
graph display ($eflags & 1) != 0 // c\n\
9416
graph display ($eflags & 64) != 0 // z\n\
9417
graph display ($eflags & 128) != 0 // s\n\
9418
graph display ($eflags & 1024) != 0 // d\n\
9419
graph display ($eflags & 2048) != 0 // o\n\
9420
graph display $eax & 255 // al\n\
9421
graph display $eax >> 8 & 255 // ah\n\
9422
graph display $eax & 65535 // ax\n\
9423
graph display $ebx & 255 // bl\n\
9424
graph display $ebx >> 8 & 255 // bh\n\
9425
graph display $ebx & 65535 // bx\n\
9426
graph display $ecx & 255 // cl\n\
9427
graph display $ecx >> 8 & 255 // ch\n\
9428
graph display $ecx & 65535 // cx\n\
9429
graph display $edx & 255 // dl\n\
9430
graph display $edx >> 8 & 255 // dh\n\
9431
graph display $edx & 65535 // dx
9432
</pre>
9433
<p>Whenever the these displays is shown, the title will be replaced by a
9434
more intuitive title like “carry”, or “zero” for one of the flag bits
9435
and “al” “ax”, etc. for one of the registers.
9436
9437
</dl>
10742
9438
10743
9439
<p>Each of these themes can be applied for specific displays.
10744
9440
10745
<br><p>
9441
<pre class="sp">
9442
9443
</pre>
10746
9444
<div align="center"><img src="PICS/ddd-themes.jpg" alt="PICS/ddd-themes.jpg"></div>
10747
<br><p>
10748
<p>To apply a theme on a display,
9445
<pre class="sp">
9446
9447
</pre>
9448
9449
<a name="index-Theme-1042"></a>To apply a theme on a display,
10749
9450
<ol type=1 start=1>
10750
9451
<li>Press <em>mouse button 3</em> on the display.
10751
<li>Select <code>Theme</code>
9452
<li>Select ‘<samp><span class="samp">Theme</span></samp>’
10752
9453
<li>Select the theme to apply.
10753
9454
</ol>
10754
9455
10755
9456
<p>For instance, to display the variable <code>s</code> in a tiny font, click
10756
<em>mouse button 3</em> on the display of <code>s</code>, and select <code>Theme
10757
=> Tiny Values => Apply</code>.
9457
<em>mouse button 3</em> on the display of <code>s</code>, and select ‘<samp><span class="samp">Theme
9458
Tiny Values Apply</span></samp>’.
10758
9459
10759
<p>To unapply a theme, just click on <code>Undo</code> (if you just applied it)
9460
<p>To unapply a theme, just click on ‘<samp><span class="samp">Undo</span></samp>’ (if you just applied it)
10760
9461
or repeat the sequence as above.
10761
9462
10762
9463
<div class="node">
10763
9464
<p><hr>
10764
<small class=header>
10765
Node:<a name="Applying%20Data%20Themes%20to%20Several%20Values">Applying Data Themes to Several Values</a>,
10766
Next:<a rel="next" accesskey="n" href="#Editing%20Themes">Editing Themes</a>,
10767
Previous:<a rel="previous" accesskey="p" href="#Using%20Data%20Themes">Using Data Themes</a>,
10768
Up:<a rel="up" accesskey="u" href="#Customizing%20Displays">Customizing Displays</a>
9465
<a name="Applying-Data-Themes-to-Several-Values"></a>
9466
Next: <a rel="next" accesskey="n" href="#Editing-Themes">Editing Themes</a>,
9467
Previous: <a rel="previous" accesskey="p" href="#Using-Data-Themes">Using Data Themes</a>,
9468
Up: <a rel="up" accesskey="u" href="#Customizing-Displays">Customizing Displays</a>
10769
9469
</small>
10770
9470
10771
<br>
9471
10772
9472
</div>
10773
9473
10774
<h5 class="subsubsection">Applying Data Themes to Several Values</h5>
9474
<h5 class="subsubsection">7.3.5.2 Applying Data Themes to Several Values</h5>
10775
9475
10776
<p>Whenever you want to apply a theme on a <em>struct member</em> or an
9476
<p>Whenever you want to apply a theme on a <em>struct member</em> or an
10777
9477
<em>array element,</em> you will be asked whether to
10778
9478
10779
9479
<ul>
10781
9481
<li>apply the theme on all similar values.
10782
9482
</ul>
10783
9483
10784
<p>Suppose, for instance, that you don't want to see <code>vptr</code> members
9484
<p>Suppose, for instance, that you don't want to see ‘<samp><span class="samp">vptr</span></samp>’ members
10785
9485
anymore. Then you'd apply the theme <em>Suppress Values</em> on all
10786
9486
similar values.
10787
9487
10788
<p>On the other hand, if you want to highlight one single value only, you'd
9488
<p><a name="index-Red-Background-1043"></a>On the other hand, if you want to highlight one single value only, you'd
10789
9489
apply the theme <em>Red Background</em> on only one single value.
10790
9490
10791
9491
<p>If you find this confirmation annoying, you can define a command button
10792
which directly applies the theme. See <a href="#Defining%20Commands">Defining Commands</a>, for details
9492
which directly applies the theme. See <a href="#Defining-Commands">Defining Commands</a>, for details
10793
9493
on defining commands.
10794
9494
10795
9495
<p>Applying and unapplying themes is associated with the following commands:
10796
9496
9497
<p><a name="index-graph-apply-theme-1044"></a>
10797
9498
<pre class="example"> graph apply theme <var>name</var> <var>pattern</var>
10798
</pre>
10799
applies the theme <var>name</var> on <var>pattern</var>.
9499
</pre>
9500
<p>applies the theme <var>name</var> on <var>pattern</var>.
10800
9501
9502
<p><a name="index-graph-unapply-theme-1045"></a>
10801
9503
<pre class="example"> graph unapply theme <var>name</var> <var>pattern</var>
10802
</pre>
10803
unapplies the theme <var>name</var> on <var>pattern</var>.
9504
</pre>
9505
<p>unapplies the theme <var>name</var> on <var>pattern</var>.
10804
9506
9507
<p><a name="index-graph-toggle-theme-1046"></a>
10805
9508
<pre class="example"> graph toggle theme <var>name</var> <var>pattern</var>
10806
</pre>
10807
applies the theme <var>name</var> on <var>pattern</var> if it was not already
9509
</pre>
9510
<p>applies the theme <var>name</var> on <var>pattern</var> if it was not already
10808
9511
applied, and unapplies it otherwise.
10809
9512
10810
9513
<div class="node">
10811
9514
<p><hr>
10812
<small class=header>
10813
Node:<a name="Editing%20Themes">Editing Themes</a>,
10814
Next:<a rel="next" accesskey="n" href="#Writing%20Data%20Themes">Writing Data Themes</a>,
10815
Previous:<a rel="previous" accesskey="p" href="#Applying%20Data%20Themes%20to%20Several%20Values">Applying Data Themes to Several Values</a>,
10816
Up:<a rel="up" accesskey="u" href="#Customizing%20Displays">Customizing Displays</a>
9515
<a name="Editing-Themes"></a>
9516
Next: <a rel="next" accesskey="n" href="#Writing-Data-Themes">Writing Data Themes</a>,
9517
Previous: <a rel="previous" accesskey="p" href="#Applying-Data-Themes-to-Several-Values">Applying Data Themes to Several Values</a>,
9518
Up: <a rel="up" accesskey="u" href="#Customizing-Displays">Customizing Displays</a>
10817
9519
</small>
10818
9520
10819
<br>
9521
10820
9522
</div>
10821
9523
10822
<h5 class="subsubsection">Editing Themes</h5>
9524
<h5 class="subsubsection">7.3.5.3 Editing Themes</h5>
10823
9525
10824
<p>Each theme can be globally activated or not. If a theme is activated,
9526
<p><a name="index-Theme_002c-editing-1047"></a>Each theme can be globally activated or not. If a theme is activated,
10825
9527
it is applied to all expressions that match its <em>pattern</em>.
10826
9528
10827
9529
<p>Normally, these patterns are automatically maintained by simply
10828
9530
selecting the themes for the individual displays. However, you can also
10829
9531
edit patterns directly.
10830
9532
10831
<p>Patterns are separated by <code>;</code> and contain shell-like metacharacters:
9533
<p>Patterns are separated by ‘<samp><span class="samp">;</span></samp>’ and contain shell-like metacharacters:
10832
9534
<ul>
10833
<li><code>*</code> matches any sequence of characters.
10834
<li><code>?</code> matches any single character.
10835
<li><code>[</code><var>set</var><code>]</code> matches any character in <var>set</var>. Character ranges
10836
can be expressed using <var>from</var>-<var>to</var>: <code>[0-9a-zA-Z_]</code> is the
9535
<li>‘<samp><span class="samp">*</span></samp>’ matches any sequence of characters.
9536
<li>‘<samp><span class="samp">?</span></samp>’ matches any single character.
9537
<li>‘<samp><span class="samp">[</span><var>set</var><span class="samp">]</span></samp>’ matches any character in <var>set</var>. Character ranges
9538
can be expressed using <var>from</var>-<var>to</var>: ‘<samp><span class="samp">[0-9a-zA-Z_]</span></samp>’ is the
10837
9539
set of characters allowed in C characters.
10838
<li><code>[!</code><var>set</var><code>]</code> matches any character not in <var>set</var>.
9540
<li>‘<samp><span class="samp">[!</span><var>set</var><span class="samp">]</span></samp>’ matches any character not in <var>set</var>.
10839
9541
<li>To suppress the special syntactic significance of any metacharacter\n\
10840
and match the character exactly, precede it with <code>\</code> (backslash).
9542
and match the character exactly, precede it with ‘<samp><span class="samp">\</span></samp>’ (backslash).
10841
9543
<li>To suppress the syntactic significance of <em>all</em> metacharacters,\n\
10842
9544
enclose the pattern in double or single quotes.\n\
10843
9545
</ul>
10844
9546
10845
<p>To edit the set of themes, invoke <code>Data => Themes</code>.
9547
<p><a name="index-Themes-1048"></a><a name="index-Edit-Themes-1049"></a>To edit the set of themes, invoke ‘<samp><span class="samp">Data Themes</span></samp>’.
10846
9548
10847
<p>To apply changes you made to the themes, click on <code>Apply</code>.
10848
To revert the themes to the last saved, click on <code>Reset</code>.
9549
<p>To apply changes you made to the themes, click on ‘<samp><span class="samp">Apply</span></samp>’.
9550
To revert the themes to the last saved, click on ‘<samp><span class="samp">Reset</span></samp>’.
10849
9551
10850
9552
<div class="node">
10851
9553
<p><hr>
10852
<small class=header>
10853
Node:<a name="Writing%20Data%20Themes">Writing Data Themes</a>,
10854
Next:<a rel="next" accesskey="n" href="#Display%20Resources">Display Resources</a>,
10855
Previous:<a rel="previous" accesskey="p" href="#Editing%20Themes">Editing Themes</a>,
10856
Up:<a rel="up" accesskey="u" href="#Customizing%20Displays">Customizing Displays</a>
9554
<a name="Writing-Data-Themes"></a>
9555
Next: <a rel="next" accesskey="n" href="#Display-Resources">Display Resources</a>,
9556
Previous: <a rel="previous" accesskey="p" href="#Editing-Themes">Editing Themes</a>,
9557
Up: <a rel="up" accesskey="u" href="#Customizing-Displays">Customizing Displays</a>
10857
9558
</small>
10858
9559
10859
<br>
9560
10860
9561
</div>
10861
9562
10862
<h5 class="subsubsection">Writing Data Themes</h5>
9563
<h5 class="subsubsection">7.3.5.4 Writing Data Themes</h5>
10863
9564
10864
<p>You can write your own data themes, customizing the display to match
9565
<p>You can write your own data themes, customizing the display to match
10865
9566
your need. See <a href="ddd-themes.html#Top">Top</a>, for details.
10866
9567
10867
9568
<div class="node">
10868
9569
<p><hr>
10869
<small class=header>
10870
Node:<a name="Display%20Resources">Display Resources</a>,
10871
Next:<a rel="next" accesskey="n" href="#VSL%20Resources">VSL Resources</a>,
10872
Previous:<a rel="previous" accesskey="p" href="#Writing%20Data%20Themes">Writing Data Themes</a>,
10873
Up:<a rel="up" accesskey="u" href="#Customizing%20Displays">Customizing Displays</a>
9570
<a name="Display-Resources"></a>
9571
Next: <a rel="next" accesskey="n" href="#VSL-Resources">VSL Resources</a>,
9572
Previous: <a rel="previous" accesskey="p" href="#Writing-Data-Themes">Writing Data Themes</a>,
9573
Up: <a rel="up" accesskey="u" href="#Customizing-Displays">Customizing Displays</a>
10874
9574
</small>
10875
9575
10876
<br>
9576
10877
9577
</div>
10878
9578
10879
<h5 class="subsubsection">Display Resources</h5>
10880
10881
<p>You can use these resources to control display appearance:
10882
10883
<p>
10884
<table width="100%">
10885
<tr>
10886
<td align="left"><b>autoCloseDataWindow</b><i> </i>(<i>class AutoClose</i>)<i>
10887
</i></td>
10888
<td align="right">Resource</td>
10889
</tr>
10890
</table>
10891
<table width="95%" align="center">
10892
<tr><td>
10893
If this is <code>on</code> (default) and <small>DDD</small> is in stacked window
9579
<h5 class="subsubsection">7.3.5.5 Display Resources</h5>
9580
9581
<p>You can use these resources to control display appearance:
9582
9583
<div class="defun">
9584
— Resource: <b>autoCloseDataWindow</b> (<var>class AutoClose</var>)<var><a name="index-autoCloseDataWindow-1050"></a></var><br>
9585
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’ (default) and <acronym>DDD</acronym> is in stacked window
10894
9586
mode, deleting the last display automatically closes the data window.
10895
If this is <code>off</code>, the data window stays open even after deleting
9587
If this is ‘<samp><span class="samp">off</span></samp>’, the data window stays open even after deleting
10896
9588
the last display.
10897
</td></tr>
10898
</table>
9589
</p></blockquote></div>
10899
9590
10900
<p>
10901
<table width="100%">
10902
<tr>
10903
<td align="left"><b>bumpDisplays</b><i> </i>(<i>class BumpDisplays</i>)<i>
10904
</i></td>
10905
<td align="right">Resource</td>
10906
</tr>
10907
</table>
10908
<table width="95%" align="center">
10909
<tr><td>
10910
If some display <var>d</var> changes size and this resource is <code>on</code>
10911
(default), <small>DDD</small> assigns new positions to displays below and on
9591
<div class="defun">
9592
— Resource: <b>bumpDisplays</b> (<var>class BumpDisplays</var>)<var><a name="index-bumpDisplays-1051"></a></var><br>
9593
<blockquote><p>If some display <var>d</var> changes size and this resource is ‘<samp><span class="samp">on</span></samp>’
9594
(default), <acronym>DDD</acronym> assigns new positions to displays below and on
10912
9595
the right of <var>d</var> such that the distance between displays remains
10913
constant. If this is <code>off</code>, other displays are not rearranged.
10914
</td></tr>
10915
</table>
9596
constant. If this is ‘<samp><span class="samp">off</span></samp>’, other displays are not rearranged.
9597
</p></blockquote></div>
10916
9598
10917
<p>
10918
<table width="100%">
10919
<tr>
10920
<td align="left"><b>clusterDisplays</b><i> </i>(<i>class ClusterDisplays</i>)<i>
10921
</i></td>
10922
<td align="right">Resource</td>
10923
</tr>
10924
</table>
10925
<table width="95%" align="center">
10926
<tr><td>
10927
If <code>on</code>, new independent data displays will automatically be
10928
clustered. Default is <code>off</code>, meaning to leave new displays
9599
<div class="defun">
9600
— Resource: <b>clusterDisplays</b> (<var>class ClusterDisplays</var>)<var><a name="index-clusterDisplays-1052"></a></var><br>
9601
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, new independent data displays will automatically be
9602
clustered. Default is ‘<samp><span class="samp">off</span></samp>’, meaning to leave new displays
10929
9603
unclustered.
10930
</td></tr>
10931
</table>
10932
10933
<p>
10934
<table width="100%">
10935
<tr>
10936
<td align="left"><b>hideInactiveDisplays</b><i> </i>(<i>class HideInactiveDisplays</i>)<i>
10937
</i></td>
10938
<td align="right">Resource</td>
10939
</tr>
10940
</table>
10941
<table width="95%" align="center">
10942
<tr><td>
10943
If some display gets out of scope and this resource is <code>on</code>
10944
(default), <small>DDD</small> removes it from the data display. If this is
10945
<code>off</code>, it is simply disabled.
10946
</td></tr>
10947
</table>
10948
10949
<p>
10950
<table width="100%">
10951
<tr>
10952
<td align="left"><b>showBaseDisplayTitles</b><i> </i>(<i>class ShowDisplayTitles</i>)<i>
10953
</i></td>
10954
<td align="right">Resource</td>
10955
</tr>
10956
</table>
10957
<table width="95%" align="center">
10958
<tr><td>
10959
Whether to assign titles to base (independent) displays or not.
10960
Default is <code>on</code>.
10961
</td></tr>
10962
</table>
10963
10964
<p>
10965
<table width="100%">
10966
<tr>
10967
<td align="left"><b>showDependentDisplayTitles</b><i> </i>(<i>class ShowDisplayTitles</i>)<i>
10968
</i></td>
10969
<td align="right">Resource</td>
10970
</tr>
10971
</table>
10972
<table width="95%" align="center">
10973
<tr><td>
10974
Whether to assign titles to dependent displays or not. Default is
10975
<code>off</code>.
10976
</td></tr>
10977
</table>
10978
10979
<p>
10980
<table width="100%">
10981
<tr>
10982
<td align="left"><b>suppressTheme</b><i> </i>(<i>class Theme</i>)<i>
10983
</i></td>
10984
<td align="right">Resource</td>
10985
</tr>
10986
</table>
10987
<table width="95%" align="center">
10988
<tr><td>
10989
The theme to apply when selecting <code>Undisp</code> on a data value.
10990
Default is <code>suppress.vsl</code>.
10991
</td></tr>
10992
</table>
10993
10994
<p>
10995
<table width="100%">
10996
<tr>
10997
<td align="left"><b>themes</b><i> </i>(<i>class Themes</i>)<i>
10998
</i></td>
10999
<td align="right">Resource</td>
11000
</tr>
11001
</table>
11002
<table width="95%" align="center">
11003
<tr><td>
11004
A newline-separated list of themes. Each theme has the format
9604
</p></blockquote></div>
9605
9606
<div class="defun">
9607
— Resource: <b>hideInactiveDisplays</b> (<var>class HideInactiveDisplays</var>)<var><a name="index-hideInactiveDisplays-1053"></a></var><br>
9608
<blockquote><p>If some display gets out of scope and this resource is ‘<samp><span class="samp">on</span></samp>’
9609
(default), <acronym>DDD</acronym> removes it from the data display. If this is
9610
‘<samp><span class="samp">off</span></samp>’, it is simply disabled.
9611
</p></blockquote></div>
9612
9613
<div class="defun">
9614
— Resource: <b>showBaseDisplayTitles</b> (<var>class ShowDisplayTitles</var>)<var><a name="index-showBaseDisplayTitles-1054"></a></var><br>
9615
<blockquote><p>Whether to assign titles to base (independent) displays or not.
9616
Default is ‘<samp><span class="samp">on</span></samp>’.
9617
</p></blockquote></div>
9618
9619
<div class="defun">
9620
— Resource: <b>showDependentDisplayTitles</b> (<var>class ShowDisplayTitles</var>)<var><a name="index-showDependentDisplayTitles-1055"></a></var><br>
9621
<blockquote><p>Whether to assign titles to dependent displays or not. Default is
9622
‘<samp><span class="samp">off</span></samp>’.
9623
</p></blockquote></div>
9624
9625
<div class="defun">
9626
— Resource: <b>suppressTheme</b> (<var>class Theme</var>)<var><a name="index-suppressTheme-1056"></a></var><br>
9627
<blockquote><p><a name="index-suppress_002evsl-1057"></a>The theme to apply when selecting ‘<samp><span class="samp">Undisp</span></samp>’ on a data value.
9628
Default is <samp><span class="file">suppress.vsl</span></samp>.
9629
</p></blockquote></div>
9630
9631
<div class="defun">
9632
— Resource: <b>themes</b> (<var>class Themes</var>)<var><a name="index-themes-1058"></a></var><br>
9633
<blockquote><p>A newline-separated list of themes. Each theme has the format
11005
9634
<var>name</var>, tabulator character, <var>pattern</var>.
11006
</td></tr>
11007
</table>
9635
</p></blockquote></div>
11008
9636
11009
9637
<div class="node">
11010
9638
<p><hr>
11011
<small class=header>
11012
Node:<a name="VSL%20Resources">VSL Resources</a>,
11013
Previous:<a rel="previous" accesskey="p" href="#Display%20Resources">Display Resources</a>,
11014
Up:<a rel="up" accesskey="u" href="#Customizing%20Displays">Customizing Displays</a>
9639
<a name="VSL-Resources"></a>
9640
Previous: <a rel="previous" accesskey="p" href="#Display-Resources">Display Resources</a>,
9641
Up: <a rel="up" accesskey="u" href="#Customizing-Displays">Customizing Displays</a>
11015
9642
</small>
11016
9643
11017
<br>
9644
11018
9645
</div>
11019
9646
11020
<h5 class="subsubsection">VSL Resources</h5>
11021
11022
<p>The following resources control the <small>VSL</small> interpreter:
11023
11024
<p>
11025
<table width="100%">
11026
<tr>
11027
<td align="left"><b>vslBaseDefs</b><i> </i>(<i>class VSLDefs</i>)<i>
11028
</i></td>
11029
<td align="right">Resource</td>
11030
</tr>
11031
</table>
11032
<table width="95%" align="center">
11033
<tr><td>
11034
A string with additional <small>VSL</small> definitions that are appended to the
11035
builtin <small>VSL</small> library. This resource is prepended to the <code>vslDefs</code>
11036
resource below and set in the <small>DDD</small> application defaults file;
9647
<h5 class="subsubsection">7.3.5.6 VSL Resources</h5>
9648
9649
<p>The following resources control the <acronym>VSL</acronym> interpreter:
9650
9651
<div class="defun">
9652
— Resource: <b>vslBaseDefs</b> (<var>class VSLDefs</var>)<var><a name="index-vslBaseDefs-1059"></a></var><br>
9653
<blockquote><p>A string with additional <acronym>VSL</acronym> definitions that are appended to the
9654
builtin <acronym>VSL</acronym> library. This resource is prepended to the ‘<samp><span class="samp">vslDefs</span></samp>’
9655
resource below and set in the <acronym>DDD</acronym> application defaults file;
11037
9656
don't change it.
11038
</td></tr>
11039
</table>
9657
</p></blockquote></div>
11040
9658
11041
<p>
11042
<table width="100%">
11043
<tr>
11044
<td align="left"><b>vslDefs</b><i> </i>(<i>class VSLDefs</i>)<i>
11045
</i></td>
11046
<td align="right">Resource</td>
11047
</tr>
11048
</table>
11049
<table width="95%" align="center">
11050
<tr><td>
11051
A string with additional <small>VSL</small> definitions that are appended to the
11052
builtin <small>VSL</small> library. The default value is an empty string. This
11053
resource can be used to override specific <small>VSL</small> definitions that affect
9659
<div class="defun">
9660
— Resource: <b>vslDefs</b> (<var>class VSLDefs</var>)<var><a name="index-vslDefs-1060"></a></var><br>
9661
<blockquote><p>A string with additional <acronym>VSL</acronym> definitions that are appended to the
9662
builtin <acronym>VSL</acronym> library. The default value is an empty string. This
9663
resource can be used to override specific <acronym>VSL</acronym> definitions that affect
11054
9664
the data display. The preferred method, though, is to write a specific
11055
data theme (see <a href="#Writing%20Data%20Themes">Writing Data Themes</a>).
11056
</td></tr>
11057
</table>
9665
data theme (see <a href="#Writing-Data-Themes">Writing Data Themes</a>).
9666
</p></blockquote></div>
11058
9667
11059
<p>
11060
<table width="100%">
11061
<tr>
11062
<td align="left"><b>vslLibrary</b><i> </i>(<i>class VSLLibrary</i>)<i>
11063
</i></td>
11064
<td align="right">Resource</td>
11065
</tr>
11066
</table>
11067
<table width="95%" align="center">
11068
<tr><td>
11069
The <small>VSL</small> library to use. <code>builtin</code> (default) means to
9668
<div class="defun">
9669
— Resource: <b>vslLibrary</b> (<var>class VSLLibrary</var>)<var><a name="index-vslLibrary-1061"></a></var><br>
9670
<blockquote><p>The <acronym>VSL</acronym> library to use. ‘<samp><span class="samp">builtin</span></samp>’ (default) means to
11070
9671
use the built-in library, any other value is used as file name.
11071
</td></tr>
11072
</table>
9672
</p></blockquote></div>
11073
9673
11074
<p>
11075
<table width="100%">
11076
<tr>
11077
<td align="left"><b>vslPath</b><i> </i>(<i>class VSLPath</i>)<i>
11078
</i></td>
11079
<td align="right">Resource</td>
11080
</tr>
11081
</table>
11082
<table width="95%" align="center">
11083
<tr><td>
11084
A colon-separated list of directories to search for <small>VSL</small> include
9674
<div class="defun">
9675
— Resource: <b>vslPath</b> (<var>class VSLPath</var>)<var><a name="index-vslPath-1062"></a></var><br>
9676
<blockquote><p>A colon-separated list of directories to search for <acronym>VSL</acronym> include
11085
9677
files. The following directory names are special:
11086
9678
<ul>
11087
<li>The special directory name <code>user_themes</code> stands for your individual
11088
theme directory, typically <code>~/.ddd/themes/</code>.
11089
<li>The special directory name <code>ddd_themes</code> stands for the installed
9679
<li>The special directory name ‘<samp><span class="samp">user_themes</span></samp>’ stands for your individual
9680
theme directory, typically <samp><span class="file">~/.ddd/themes/</span></samp>.
9681
<li>The special directory name ‘<samp><span class="samp">ddd_themes</span></samp>’ stands for the installed
11090
9682
theme directory,
11091
typically <code>/usr/local/share/ddd-3.3.11/themes/</code>.
9683
typically <samp><span class="file">/usr/local/share/ddd-3.3.12/themes/</span></samp>.
11092
9684
</ul>
11093
Default is <code>user_themes:ddd_themes:.</code>, which means that <small>DDD</small>
9685
Default is ‘<samp><span class="samp">user_themes:ddd_themes:.</span></samp>’, which means that <acronym>DDD</acronym>
11094
9686
first searches your theme directory, followed by the system directory
11095
9687
and the current directory.
11096
</td></tr>
11097
</table>
9688
</p></blockquote></div>
11098
9689
11099
<p>If your <small>DDD</small> source distribution is installed in <code>/opt/src</code>,
11100
you can use the following settings to read the <small>VSL</small> library from
11101
<code>/home/joe/ddd.vsl</code>:
9690
<p>If your <acronym>DDD</acronym> source distribution is installed in <samp><span class="file">/opt/src</span></samp>,
9691
you can use the following settings to read the <acronym>VSL</acronym> library from
9692
<samp><span class="file">/home/joe/ddd.vsl</span></samp>:
11102
9693
11103
9694
<pre class="example"> Ddd*vslLibrary: /home/joe/ddd.vsl
11104
9695
Ddd*vslPath: user_themes:.:/opt/src/ddd/ddd:/opt/src/ddd/vsllib
11105
</pre>
11106
11107
<p><small>VSL</small> include files referenced by <code>/home/joe/ddd.vsl</code> are searched
11108
first in the current directory <code>.</code>, then in your theme directory,
11109
then in <code>/opt/src/ddd/ddd/</code>, and then in
11110
<code>/opt/src/ddd/vsllib/</code>.
11111
11112
<p>Instead of supplying another <small>VSL</small> library, it is often easier to
9696
</pre>
9697
<p><acronym>VSL</acronym> include files referenced by <samp><span class="file">/home/joe/ddd.vsl</span></samp> are searched
9698
first in the current directory <samp><span class="file">.</span></samp>, then in your theme directory,
9699
then in <samp><span class="file">/opt/src/ddd/ddd/</span></samp>, and then in
9700
<samp><span class="file">/opt/src/ddd/vsllib/</span></samp>.
9701
9702
<p>Instead of supplying another <acronym>VSL</acronym> library, it is often easier to
11113
9703
specify some minor changes to the built-in library
11114
(see <a href="#Writing%20Data%20Themes">Writing Data Themes</a>).
9704
(see <a href="#Writing-Data-Themes">Writing Data Themes</a>).
11115
9705
11116
9706
<div class="node">
11117
9707
<p><hr>
11118
<small class=header>
11119
Node:<a name="Layouting%20the%20Graph">Layouting the Graph</a>,
11120
Next:<a rel="next" accesskey="n" href="#Printing%20the%20Graph">Printing the Graph</a>,
11121
Previous:<a rel="previous" accesskey="p" href="#Customizing%20Displays">Customizing Displays</a>,
11122
Up:<a rel="up" accesskey="u" href="#Displaying%20Values">Displaying Values</a>
9708
<a name="Layouting-the-Graph"></a>
9709
Next: <a rel="next" accesskey="n" href="#Printing-the-Graph">Printing the Graph</a>,
9710
Previous: <a rel="previous" accesskey="p" href="#Customizing-Displays">Customizing Displays</a>,
9711
Up: <a rel="up" accesskey="u" href="#Displaying-Values">Displaying Values</a>
11123
9712
</small>
11124
9713
11125
<br>
9714
11126
9715
</div>
11127
9716
11128
<h4 class="subsection">Layouting the Graph</h4>
9717
<h4 class="subsection">7.3.6 Layouting the Graph</h4>
11129
9718
11130
<p>If you have several displays at once, you may wish to arrange them
9719
<p>If you have several displays at once, you may wish to arrange them
11131
9720
according to your personal preferences. This section tells you how you
11132
9721
can do this.
11133
9722
11134
9723
<ul class="menu">
11135
<li><a accesskey="1" href="#Moving%20Displays">Moving Displays</a>:
11136
<li><a accesskey="2" href="#Scrolling%20Data">Scrolling Data</a>:
11137
<li><a accesskey="3" href="#Aligning%20Displays">Aligning Displays</a>:
11138
<li><a accesskey="4" href="#Automatic%20Layout">Automatic Layout</a>:
11139
<li><a accesskey="5" href="#Rotating%20the%20Graph">Rotating the Graph</a>:
9724
<li><a accesskey="1" href="#Moving-Displays">Moving Displays</a>
9725
<li><a accesskey="2" href="#Scrolling-Data">Scrolling Data</a>
9726
<li><a accesskey="3" href="#Aligning-Displays">Aligning Displays</a>
9727
<li><a accesskey="4" href="#Automatic-Layout">Automatic Layout</a>
9728
<li><a accesskey="5" href="#Rotating-the-Graph">Rotating the Graph</a>
11140
9729
</ul>
11141
9730
11142
9731
<div class="node">
11143
9732
<p><hr>
11144
<small class=header>
11145
Node:<a name="Moving%20Displays">Moving Displays</a>,
11146
Next:<a rel="next" accesskey="n" href="#Scrolling%20Data">Scrolling Data</a>,
11147
Up:<a rel="up" accesskey="u" href="#Layouting%20the%20Graph">Layouting the Graph</a>
9733
<a name="Moving-Displays"></a>
9734
Next: <a rel="next" accesskey="n" href="#Scrolling-Data">Scrolling Data</a>,
9735
Up: <a rel="up" accesskey="u" href="#Layouting-the-Graph">Layouting the Graph</a>
11148
9736
</small>
11149
9737
11150
<br>
9738
11151
9739
</div>
11152
9740
11153
<h5 class="subsubsection">Moving Displays</h5>
9741
<h5 class="subsubsection">7.3.6.1 Moving Displays</h5>
11154
9742
11155
<p>From time to time, you may wish to move displays at another place in the
9743
<p><a name="index-Display_002c-moving-1063"></a>
9744
From time to time, you may wish to move displays at another place in the
11156
9745
data window. You can move a single display by pressing and holding
11157
9746
<em>mouse button 1</em> on the display title. Moving the pointer while
11158
9747
holding the button causes all selected displays to move along with the
11167
9756
single pixels. Pressing <Ctrl> and arrow keys moves displays by
11168
9757
grid positions.
11169
9758
9759
<p><a name="index-Up-1064"></a><a name="index-Down-1065"></a><a name="index-Left-1066"></a><a name="index-Right-1067"></a>
9760
11170
9761
<div class="node">
11171
9762
<p><hr>
11172
<small class=header>
11173
Node:<a name="Scrolling%20Data">Scrolling Data</a>,
11174
Next:<a rel="next" accesskey="n" href="#Aligning%20Displays">Aligning Displays</a>,
11175
Previous:<a rel="previous" accesskey="p" href="#Moving%20Displays">Moving Displays</a>,
11176
Up:<a rel="up" accesskey="u" href="#Layouting%20the%20Graph">Layouting the Graph</a>
9763
<a name="Scrolling-Data"></a>
9764
Next: <a rel="next" accesskey="n" href="#Aligning-Displays">Aligning Displays</a>,
9765
Previous: <a rel="previous" accesskey="p" href="#Moving-Displays">Moving Displays</a>,
9766
Up: <a rel="up" accesskey="u" href="#Layouting-the-Graph">Layouting the Graph</a>
11177
9767
</small>
11178
9768
11179
<br>
9769
11180
9770
</div>
11181
9771
11182
<h5 class="subsubsection">Scrolling Data</h5>
9772
<h5 class="subsubsection">7.3.6.2 Scrolling Data</h5>
11183
9773
11184
<p>If the data window becomes too small to hold all displays, scroll bars
11185
are created. If your <small>DDD</small> is set up to use <em>panners</em>
9774
<p><a name="index-Scrolling-1068"></a>
9775
If the data window becomes too small to hold all displays, scroll bars
9776
are created. If your <acronym>DDD</acronym> is set up to use <em>panners</em>
11186
9777
instead, a panner is created in the lower right edge. When the panner
11187
9778
is moved around, the window view follows the position of the panner.
11188
9779
11189
<p>To change from scroll bars to panners, use <code>Edit => Startup
11190
=> Data Scrolling</code> and choose either <code>Panner</code> or
11191
<code>Scrollbars</code>.
11192
11193
<p>This setting is tied to the following resource:
11194
11195
<p>
11196
<table width="100%">
11197
<tr>
11198
<td align="left"><b>pannedGraphEditor</b><i> </i>(<i>class PannedGraphEditor</i>)<i>
11199
</i></td>
11200
<td align="right">Resource</td>
11201
</tr>
11202
</table>
11203
<table width="95%" align="center">
11204
<tr><td>
11205
The control to scroll the graph.
9780
<p>To change from scroll bars to panners, use ‘<samp><span class="samp">Edit Startup
9781
Data Scrolling</span></samp>’ and choose either ‘<samp><span class="samp">Panner</span></samp>’ or
9782
‘<samp><span class="samp">Scrollbars</span></samp>’.
9783
<a name="index-Data-Scrolling-1069"></a>
9784
This setting is tied to the following resource:
9785
9786
<div class="defun">
9787
— Resource: <b>pannedGraphEditor</b> (<var>class PannedGraphEditor</var>)<var><a name="index-pannedGraphEditor-1070"></a></var><br>
9788
<blockquote><p>The control to scroll the graph.
11206
9789
11207
9790
<ul>
11208
<li>If this is <code>on</code>, an Athena panner is used (a kind of
9791
<li>If this is ‘<samp><span class="samp">on</span></samp>’, an Athena panner is used (a kind of
11209
9792
two-directional scrollbar).
11210
<li>If this is <code>off</code> (default), two M*tif scrollbars are used.
9793
<li>If this is ‘<samp><span class="samp">off</span></samp>’ (default), two M*tif scrollbars are used.
11211
9794
</ul>
11212
9795
11213
<p>See <a href="#Options">Options</a>, for the <code>--scrolled-graph-editor</code> and
11214
<code>--panned-graph-editor</code> options.
11215
</td></tr>
11216
</table>
9796
<p>See <a href="#Options">Options</a>, for the <samp><span class="option">--scrolled-graph-editor</span></samp> and
9797
<samp><span class="option">--panned-graph-editor</span></samp> options.
9798
</p></blockquote></div>
11217
9799
11218
9800
<div class="node">
11219
9801
<p><hr>
11220
<small class=header>
11221
Node:<a name="Aligning%20Displays">Aligning Displays</a>,
11222
Next:<a rel="next" accesskey="n" href="#Automatic%20Layout">Automatic Layout</a>,
11223
Previous:<a rel="previous" accesskey="p" href="#Scrolling%20Data">Scrolling Data</a>,
11224
Up:<a rel="up" accesskey="u" href="#Layouting%20the%20Graph">Layouting the Graph</a>
9802
<a name="Aligning-Displays"></a>
9803
Next: <a rel="next" accesskey="n" href="#Automatic-Layout">Automatic Layout</a>,
9804
Previous: <a rel="previous" accesskey="p" href="#Scrolling-Data">Scrolling Data</a>,
9805
Up: <a rel="up" accesskey="u" href="#Layouting-the-Graph">Layouting the Graph</a>
11225
9806
</small>
11226
9807
11227
<br>
9808
11228
9809
</div>
11229
9810
11230
<h5 class="subsubsection">Aligning Displays</h5>
9811
<h5 class="subsubsection">7.3.6.3 Aligning Displays</h5>
11231
9812
11232
<p>You can align all displays on the nearest grid position by selecting
11233
<code>Data => Align on Grid</code>. This is useful for keeping edges
9813
<p><a name="index-Display_002c-aligning-on-grid-1071"></a><a name="index-Grid_002c-aligning-displays-1072"></a>
9814
You can align all displays on the nearest grid position by selecting
9815
‘<samp><span class="samp">Data Align on Grid</span></samp>’. This is useful for keeping edges
11234
9816
strictly horizontal or vertical.
11235
9817
11236
<p>You can enforce alignment by selecting <code>Edit => Preferences
11237
=> Data => Auto-align Displays on Nearest Grid Point</code>. If
9818
<p><a name="index-Auto_002dalign-Displays-on-Nearest-Grid-Point-1073"></a>You can enforce alignment by selecting ‘<samp><span class="samp">Edit Preferences
9819
Data Auto-align Displays on Nearest Grid Point</span></samp>’. If
11238
9820
this feature is enabled, displays can be moved on grid positions only.
11239
9821
11240
9822
<div class="node">
11241
9823
<p><hr>
11242
<small class=header>
11243
Node:<a name="Automatic%20Layout">Automatic Layout</a>,
11244
Next:<a rel="next" accesskey="n" href="#Rotating%20the%20Graph">Rotating the Graph</a>,
11245
Previous:<a rel="previous" accesskey="p" href="#Aligning%20Displays">Aligning Displays</a>,
11246
Up:<a rel="up" accesskey="u" href="#Layouting%20the%20Graph">Layouting the Graph</a>
9824
<a name="Automatic-Layout"></a>
9825
Next: <a rel="next" accesskey="n" href="#Rotating-the-Graph">Rotating the Graph</a>,
9826
Previous: <a rel="previous" accesskey="p" href="#Aligning-Displays">Aligning Displays</a>,
9827
Up: <a rel="up" accesskey="u" href="#Layouting-the-Graph">Layouting the Graph</a>
11247
9828
</small>
11248
9829
11249
<br>
9830
11250
9831
</div>
11251
9832
11252
<h5 class="subsubsection">Automatic Layout</h5>
9833
<h5 class="subsubsection">7.3.6.4 Automatic Layout</h5>
11253
9834
11254
<p>You can layout the entire graph as a tree by selecting <code>Data
11255
=> Layout Graph</code>. The layout direction is determined from the
9835
<p><a name="index-Layout-Graph-1074"></a>You can layout the entire graph as a tree by selecting ‘<samp><span class="samp">Data
9836
Layout Graph</span></samp>’. The layout direction is determined from the
11256
9837
display placement (see <a href="#Placement">Placement</a>) and from the last rotation
11257
(see <a href="#Rotating%20the%20Graph">Rotating the Graph</a>).
11258
11259
<br><p>
9838
(see <a href="#Rotating-the-Graph">Rotating the Graph</a>).
9839
9840
<pre class="sp">
9841
9842
</pre>
11260
9843
<div align="center"><img src="PICS/ddd-layout.jpg" alt="PICS/ddd-layout.jpg"></div>
11261
<br><p>
11262
<p>Layouting the graph may introduce <dfn>edge hints</dfn>; that is, edges are
9844
<pre class="sp">
9845
9846
</pre>
9847
9848
<a name="index-Edge-hint-1075"></a>Layouting the graph may introduce <dfn>edge hints</dfn>; that is, edges are
11263
9849
no more straight lines, but lead to an edge hint and from there to their
11264
9850
destination. Edge hints can be moved around like arbitrary displays.
11265
9851
11266
<p>To enable a more compact layout, you can set the <code>Edit =>
11267
Preferences => Data => Compact Layout</code> option. This
9852
<p><a name="index-Compact-Layout-1076"></a>To enable a more compact layout, you can set the ‘<samp><span class="samp">Edit
9853
Preferences Data Compact Layout</span></samp>’ option. This
11268
9854
realizes an alternate layout algorithm, where successors are placed next
11269
9855
to their parents. This algorithm is suitable for homogeneous data
11270
9856
structures only.
11271
9857
11272
<p>You can enforce layout by setting <code>Edit => Preferences
11273
=> Data => Automatic Layout</code>. If automatic layout is
9858
<p><a name="index-Automatic-Layout-1077"></a>You can enforce layout by setting ‘<samp><span class="samp">Edit Preferences
9859
Data Automatic Layout</span></samp>’. If automatic layout is
11274
9860
enabled, the graph is layouted after each change.
11275
9861
11276
9862
<div class="node">
11277
9863
<p><hr>
11278
<small class=header>
11279
Node:<a name="Rotating%20the%20Graph">Rotating the Graph</a>,
11280
Previous:<a rel="previous" accesskey="p" href="#Automatic%20Layout">Automatic Layout</a>,
11281
Up:<a rel="up" accesskey="u" href="#Layouting%20the%20Graph">Layouting the Graph</a>
9864
<a name="Rotating-the-Graph"></a>
9865
Previous: <a rel="previous" accesskey="p" href="#Automatic-Layout">Automatic Layout</a>,
9866
Up: <a rel="up" accesskey="u" href="#Layouting-the-Graph">Layouting the Graph</a>
11282
9867
</small>
11283
9868
11284
<br>
9869
11285
9870
</div>
11286
9871
11287
<h5 class="subsubsection">Rotating the Graph</h5>
9872
<h5 class="subsubsection">7.3.6.5 Rotating the Graph</h5>
11288
9873
11289
<p>You can rotate the entire graph clockwise by 90 degrees by selecting
11290
<code>Data => Rotate Graph</code>. You may need to layout the graph
11291
after rotating it; See <a href="#Automatic%20Layout">Automatic Layout</a>, for details.
9874
<p><a name="index-Graph_002c-rotating-1078"></a><a name="index-Rotating-the-graph-1079"></a><a name="index-Rotate-Graph-1080"></a>
9875
You can rotate the entire graph clockwise by 90 degrees by selecting
9876
‘<samp><span class="samp">Data Rotate Graph</span></samp>’. You may need to layout the graph
9877
after rotating it; See <a href="#Automatic-Layout">Automatic Layout</a>, for details.
11292
9878
11293
9879
<div class="node">
11294
9880
<p><hr>
11295
<small class=header>
11296
Node:<a name="Printing%20the%20Graph">Printing the Graph</a>,
11297
Previous:<a rel="previous" accesskey="p" href="#Layouting%20the%20Graph">Layouting the Graph</a>,
11298
Up:<a rel="up" accesskey="u" href="#Displaying%20Values">Displaying Values</a>
9881
<a name="Printing-the-Graph"></a>
9882
Previous: <a rel="previous" accesskey="p" href="#Layouting-the-Graph">Layouting the Graph</a>,
9883
Up: <a rel="up" accesskey="u" href="#Displaying-Values">Displaying Values</a>
11299
9884
</small>
11300
9885
11301
<br>
9886
11302
9887
</div>
11303
9888
11304
<h4 class="subsection">Printing the Graph</h4>
9889
<h4 class="subsection">7.3.7 Printing the Graph</h4>
11305
9890
11306
<p><small>DDD</small> allows for printing the graph picture on PostScript printers
9891
<p><a name="index-Graph_002c-printing-1081"></a><a name="index-Printing-the-Graph-1082"></a>
9892
<acronym>DDD</acronym> allows for printing the graph picture on PostScript printers
11307
9893
or into files. This is useful for documenting program states.
11308
9894
11309
<br><p>
9895
<pre class="sp">
9896
9897
</pre>
11310
9898
<div align="center"><img src="PICS/ddd-print-graph.jpg" alt="PICS/ddd-print-graph.jpg"></div>
11311
<br><p>
11312
<p>To print the graph on a PostScript printer, select <code>File =>
11313
Print Graph</code>. Enter the printing command in the <code>Print Command</code>
11314
field. Click on the <code>OK</code> or the <code>Apply</code> button to start
9899
<pre class="sp">
9900
9901
</pre>
9902
9903
<a name="index-Print-Graph-1083"></a><a name="index-Print-Command-1084"></a>To print the graph on a PostScript printer, select ‘<samp><span class="samp">File
9904
Print Graph</span></samp>’. Enter the printing command in the ‘<samp><span class="samp">Print Command</span></samp>’
9905
field. Click on the ‘<samp><span class="samp">OK</span></samp>’ or the ‘<samp><span class="samp">Apply</span></samp>’ button to start
11315
9906
printing.
11316
9907
11317
<p>As an alternative, you may also print the graph in a file. Click on the
11318
<code>File</code> button and enter the file name in the <code>File Name</code>
11319
field. Click on the <code>Print</code> button to create the file.
9908
<p><a name="index-File-Name-1085"></a>As an alternative, you may also print the graph in a file. Click on the
9909
‘<samp><span class="samp">File</span></samp>’ button and enter the file name in the ‘<samp><span class="samp">File Name</span></samp>’
9910
field. Click on the ‘<samp><span class="samp">Print</span></samp>’ button to create the file.
11320
9911
11321
9912
<p>When the graph is printed in a file, two formats are available:
11322
9913
11323
9914
<ul>
11324
<li><code>PostScript</code>--suitable for enclosing the graph in another
9915
<li><a name="index-PostScript_002c-printing-as-1086"></a>‘<samp><span class="samp">PostScript</span></samp>’—suitable for enclosing the graph in another
11325
9916
document;
11326
9917
11327
<li><code>FIG</code>--suitable for post-processing, using the <code>xfig</code>
9918
<li><a name="index-FIG-file_002c-printing-as-1087"></a><a name="index-IBMGL-file_002c-printing-as-1088"></a><a name="index-g_t_0040TeX_007b_007d-file_002c-printing-as-1089"></a><a name="index-PIC-file_002c-printing-as-1090"></a>‘<samp><span class="samp">FIG</span></samp>’—suitable for post-processing, using the <samp><span class="command">xfig</span></samp>
11328
9919
graphic editor, or for conversion into other formats (among others,
11329
<small>IBMGL</small>, TeX, <small>PIC</small>), using the <code>transfig</code> or
11330
<code>fig2dev</code> programs.
11331
</ul>
11332
11333
<br><p>
9920
<acronym>IBMGL</acronym>, TeX, <acronym>PIC</acronym>), using the <samp><span class="command">transfig</span></samp> or
9921
<samp><span class="command">fig2dev</span></samp> programs.
9922
<a name="index-xfig-1091"></a><a name="index-transfig-1092"></a><a name="index-fig2dev-1093"></a></ul>
9923
9924
<pre class="sp">
9925
9926
</pre>
11334
9927
<div align="center"><img src="PICS/ddd-print-output.jpg" alt="PICS/ddd-print-output.jpg"></div>
11335
<br><p>
11336
<p>Please note the following <em>caveats</em> related to printing graphs:
9928
<pre class="sp">
9929
9930
</pre>
9931
9932
Please note the following <em>caveats</em> related to printing graphs:
11337
9933
11338
9934
<ul>
11339
<li>If any displays were selected when invoking the <code>Print</code> dialog, the
11340
option <code>Selected Only</code> is set. This makes <small>DDD</small> print only
9935
<li><a name="index-Selected-Only-1094"></a>If any displays were selected when invoking the ‘<samp><span class="samp">Print</span></samp>’ dialog, the
9936
option ‘<samp><span class="samp">Selected Only</span></samp>’ is set. This makes <acronym>DDD</acronym> print only
11341
9937
the selected displays.
11342
9938
11343
<li>The <code>Color</code>, <code>Orientation</code>, and <code>Paper Size</code> options are
9939
<li><a name="index-Color-1095"></a><a name="index-Orientation-1096"></a><a name="index-Paper-Size-1097"></a>The ‘<samp><span class="samp">Color</span></samp>’, ‘<samp><span class="samp">Orientation</span></samp>’, and ‘<samp><span class="samp">Paper Size</span></samp>’ options are
11344
9940
meaningful for PostScript only.
11345
9941
</ul>
11346
9942
11347
9943
<p>These settings are tied to the following resources:
11348
9944
11349
<p>
11350
<table width="100%">
11351
<tr>
11352
<td align="left"><b>printCommand</b><i> </i>(<i>class PrintCommand</i>)<i>
11353
</i></td>
11354
<td align="right">Resource</td>
11355
</tr>
11356
</table>
11357
<table width="95%" align="center">
11358
<tr><td>
11359
The command to print a PostScript file. Usually <code>lp</code> or
11360
<code>lpr</code>.
11361
</td></tr>
11362
</table>
9945
<div class="defun">
9946
— Resource: <b>printCommand</b> (<var>class PrintCommand</var>)<var><a name="index-printCommand-1098"></a></var><br>
9947
<blockquote><p>The command to print a PostScript file. Usually ‘<samp><span class="samp">lp</span></samp>’ or
9948
‘<samp><span class="samp">lpr</span></samp>’.
9949
</p></blockquote></div>
11363
9950
11364
<p>
11365
<table width="100%">
11366
<tr>
11367
<td align="left"><b>paperSize</b><i> </i>(<i>class PaperSize</i>)<i>
11368
</i></td>
11369
<td align="right">Resource</td>
11370
</tr>
11371
</table>
11372
<table width="95%" align="center">
11373
<tr><td>
11374
The paper size used for printing, in format <code></code><var>width</var><code> x
11375
</code><var>height</var><code></code>. The default is ISO A4 format, or <code>210mm x 297mm</code>.
11376
</td></tr>
11377
</table>
9951
<div class="defun">
9952
— Resource: <b>paperSize</b> (<var>class PaperSize</var>)<var><a name="index-paperSize-1099"></a></var><br>
9953
<blockquote><p>The paper size used for printing, in format ‘<samp><var>width</var><span class="samp"> x
9954
</span><var>height</var></samp>’. The default is ISO A4 format, or ‘<samp><span class="samp">210mm x 297mm</span></samp>’.
9955
</p></blockquote></div>
11378
9956
11379
9957
<div class="node">
11380
9958
<p><hr>
11381
<small class=header>
11382
Node:<a name="Plotting%20Values">Plotting Values</a>,
11383
Next:<a rel="next" accesskey="n" href="#Examining%20Memory">Examining Memory</a>,
11384
Previous:<a rel="previous" accesskey="p" href="#Displaying%20Values">Displaying Values</a>,
11385
Up:<a rel="up" accesskey="u" href="#Examining%20Data">Examining Data</a>
9959
<a name="Plotting-Values"></a>
9960
Next: <a rel="next" accesskey="n" href="#Examining-Memory">Examining Memory</a>,
9961
Previous: <a rel="previous" accesskey="p" href="#Displaying-Values">Displaying Values</a>,
9962
Up: <a rel="up" accesskey="u" href="#Examining-Data">Examining Data</a>
11386
9963
</small>
11387
9964
11388
<br>
9965
11389
9966
</div>
11390
9967
11391
<h3 class="section">Plotting Values</h3>
9968
<h3 class="section">7.4 Plotting Values</h3>
11392
9969
11393
<p>If you have huge amounts of numerical data to examine, a picture often
11394
says more than a thousand numbers. Therefore, <small>DDD</small> allows you to
9970
<p><a name="index-Values_002c-plotting-1100"></a><a name="index-Plotting-values-1101"></a>
9971
If you have huge amounts of numerical data to examine, a picture often
9972
says more than a thousand numbers. Therefore, <acronym>DDD</acronym> allows you to
11395
9973
draw numerical values in nice 2-D and 3-D plots.
11396
9974
11397
9975
<ul class="menu">
11398
<li><a accesskey="1" href="#Plotting%20Arrays">Plotting Arrays</a>: Plotting 1-D and 2-D arrays.
11399
<li><a accesskey="2" href="#Plot%20Appearance">Plot Appearance</a>: Controlling the appearance.
11400
<li><a accesskey="3" href="#Scalars%20and%20Composites">Scalars and Composites</a>: Plotting simple values.
11401
<li><a accesskey="4" href="#Plotting%20Histories">Plotting Histories</a>: Plotting the history of a variable.
11402
<li><a accesskey="5" href="#Printing%20Plots">Printing Plots</a>: Printing on paper.
11403
<li><a accesskey="6" href="#Entering%20Plotting%20Commands">Entering Plotting Commands</a>: Raw Gnuplot commands.
11404
<li><a accesskey="7" href="#Exporting%20Plot%20Data">Exporting Plot Data</a>: Processing data outside of <small>DDD</small>
11405
<li><a accesskey="8" href="#Animating%20Plots">Animating Plots</a>: Visualizing dynamic behaviour.
11406
<li><a accesskey="9" href="#Customizing%20Plots">Customizing Plots</a>: All at your leisure.
9976
<li><a accesskey="1" href="#Plotting-Arrays">Plotting Arrays</a>: Plotting 1-D and 2-D arrays.
9977
<li><a accesskey="2" href="#Plot-Appearance">Plot Appearance</a>: Controlling the appearance.
9978
<li><a accesskey="3" href="#Scalars-and-Composites">Scalars and Composites</a>: Plotting simple values.
9979
<li><a accesskey="4" href="#Plotting-Histories">Plotting Histories</a>: Plotting the history of a variable.
9980
<li><a accesskey="5" href="#Printing-Plots">Printing Plots</a>: Printing on paper.
9981
<li><a accesskey="6" href="#Entering-Plotting-Commands">Entering Plotting Commands</a>: Raw Gnuplot commands.
9982
<li><a accesskey="7" href="#Exporting-Plot-Data">Exporting Plot Data</a>: Processing data outside of <acronym>DDD</acronym>
9983
<li><a accesskey="8" href="#Animating-Plots">Animating Plots</a>: Visualizing dynamic behaviour.
9984
<li><a accesskey="9" href="#Customizing-Plots">Customizing Plots</a>: All at your leisure.
11407
9985
</ul>
11408
9986
11409
9987
<div class="node">
11410
9988
<p><hr>
11411
<small class=header>
11412
Node:<a name="Plotting%20Arrays">Plotting Arrays</a>,
11413
Next:<a rel="next" accesskey="n" href="#Plot%20Appearance">Plot Appearance</a>,
11414
Up:<a rel="up" accesskey="u" href="#Plotting%20Values">Plotting Values</a>
9989
<a name="Plotting-Arrays"></a>
9990
Next: <a rel="next" accesskey="n" href="#Plot-Appearance">Plot Appearance</a>,
9991
Up: <a rel="up" accesskey="u" href="#Plotting-Values">Plotting Values</a>
11415
9992
</small>
11416
9993
11417
<br>
9994
11418
9995
</div>
11419
9996
11420
<h4 class="subsection">Plotting Arrays</h4>
9997
<h4 class="subsection">7.4.1 Plotting Arrays</h4>
11421
9998
11422
<p>Basically, <small>DDD</small> can plot two types of numerical values:
9999
<p><a name="index-Array_002c-plotting-1102"></a>
10000
Basically, <acronym>DDD</acronym> can plot two types of numerical values:
11423
10001
11424
10002
<ul>
11425
10003
<li>One-dimensional arrays. These are drawn in a 2-D <var>x</var>/<var>y</var> space,
11432
10010
11433
10011
<p>To plot a fixed-size array, select its name by clicking <em>mouse
11434
10012
button 1</em> on an occurrence. The array name is copied to the argument
11435
field. By clicking the <code>Plot</code> button, a new display is created in
10013
field. By clicking the ‘<samp><span class="samp">Plot</span></samp>’ button, a new display is created in
11436
10014
the data window, followed by a new top-level window containing the value
11437
10015
plot.
11438
10016
11439
10017
<p>To plot a dynamically sized array, you must use an array slice
11440
(see <a href="#Array%20Slices">Array Slices</a>). In the argument field, enter
10018
(see <a href="#Array-Slices">Array Slices</a>). In the argument field, enter
11441
10019
11442
10020
<pre class="example"> <var>array</var>[<var>first</var>]@<var>nelems</var>
11443
</pre>
11444
11445
<p>where <var>array</var> is the name of the array to display, <var>first</var> is
10021
</pre>
10022
<p class="noindent">where <var>array</var> is the name of the array to display, <var>first</var> is
11446
10023
the index of the first element, and <var>nelems</var> is the number of
11447
elements to display. Then, click on <code>Plot</code> to start the plot.
10024
elements to display. Then, click on ‘<samp><span class="samp">Plot</span></samp>’ to start the plot.
11448
10025
11449
10026
<p>To plot a value, you can also enter a command at the debugger prompt:
11450
10027
10028
<p><a name="index-graph-plot-1103"></a>
11451
10029
<pre class="example"> graph plot <var>expr</var>
11452
</pre>
11453
11454
<p>works like <code>graph display </code><var>expr</var><code></code> (and takes the same
11455
arguments; see <a href="#Creating%20Single%20Displays">Creating Single Displays</a>), but the value is
10030
</pre>
10031
<p class="noindent">works like ‘<samp><span class="samp">graph display </span><var>expr</var></samp>’ (and takes the same
10032
arguments; see <a href="#Creating-Single-Displays">Creating Single Displays</a>), but the value is
11456
10033
additionally shown in the plot window.
11457
10034
11458
10035
<p>Each time the value changes during program execution, the plot is
11459
10036
updated to reflect the current values. The plot window remains active
11460
until you close it (via <code>File => Close</code>) or until the
10037
until you close it (via ‘<samp><span class="samp">File Close</span></samp>’) or until the
11461
10038
associated display is deleted.
11462
10039
11463
10040
<div class="node">
11464
10041
<p><hr>
11465
<small class=header>
11466
Node:<a name="Plot%20Appearance">Plot Appearance</a>,
11467
Next:<a rel="next" accesskey="n" href="#Scalars%20and%20Composites">Scalars and Composites</a>,
11468
Previous:<a rel="previous" accesskey="p" href="#Plotting%20Arrays">Plotting Arrays</a>,
11469
Up:<a rel="up" accesskey="u" href="#Plotting%20Values">Plotting Values</a>
10042
<a name="Plot-Appearance"></a>
10043
Next: <a rel="next" accesskey="n" href="#Scalars-and-Composites">Scalars and Composites</a>,
10044
Previous: <a rel="previous" accesskey="p" href="#Plotting-Arrays">Plotting Arrays</a>,
10045
Up: <a rel="up" accesskey="u" href="#Plotting-Values">Plotting Values</a>
11470
10046
</small>
11471
10047
11472
<br>
10048
11473
10049
</div>
11474
10050
11475
<h4 class="subsection">Changing the Plot Appearance</h4>
10051
<h4 class="subsection">7.4.2 Changing the Plot Appearance</h4>
11476
10052
11477
<p>The actual drawing is not done by <small>DDD</small> itself. Instead,
11478
<small>DDD</small> relies on an external <code>gnuplot</code> program to create the
10053
<p><a name="index-Plot-appearance-1104"></a>
10054
<a name="index-gnuplot-1105"></a>The actual drawing is not done by <acronym>DDD</acronym> itself. Instead,
10055
<acronym>DDD</acronym> relies on an external <samp><span class="command">gnuplot</span></samp> program to create the
11479
10056
drawing.
11480
10057
11481
<p><small>DDD</small> adds a menu bar to the Gnuplot plot window that lets you
10058
<p><acronym>DDD</acronym> adds a menu bar to the Gnuplot plot window that lets you
11482
10059
influence the appearance of the plot:
11483
10060
11484
10061
<ul>
11485
<li>The <code>View</code> menu toggles optional parts of the plot, such as
10062
<li><a name="index-View-1106"></a><a name="index-Grid_002c-in-plots-1107"></a>The ‘<samp><span class="samp">View</span></samp>’ menu toggles optional parts of the plot, such as
11486
10063
border lines or a background grid.
11487
10064
11488
<li>The <code>Plot</code> menu changes the <dfn>plotting style</dfn>. The <code>3-D
11489
Lines</code> option is useful for plotting two-dimensional arrays.
10065
<li><a name="index-Plot-1108"></a><a name="index-g_t3_002dD-Lines-1109"></a><a name="index-Plotting-style-1110"></a>The ‘<samp><span class="samp">Plot</span></samp>’ menu changes the <dfn>plotting style</dfn>. The ‘<samp><span class="samp">3-D
10066
Lines</span></samp>’ option is useful for plotting two-dimensional arrays.
11490
10067
11491
<li>The <code>Scale</code> menu allows you to enable logarithmic scaling and to
10068
<li><a name="index-Scale-1111"></a><a name="index-Scales_002c-in-plots-1112"></a>The ‘<samp><span class="samp">Scale</span></samp>’ menu allows you to enable logarithmic scaling and to
11492
10069
enable or disable the scale tics.
11493
10070
11494
<li>The <code>Contour</code> menu adds contour lines to 3-D plots.
11495
</ul>
10071
<li>The ‘<samp><span class="samp">Contour</span></samp>’ menu adds contour lines to 3-D plots.
10072
<a name="index-Contour-1113"></a><a name="index-Contour-lines_002c-in-plots-1114"></a></ul>
11496
10073
11497
<p>In a 3-D plot, you can use the scroll bars to change your view position.
10074
<p><a name="index-Plot_002c-scrolling-1115"></a>In a 3-D plot, you can use the scroll bars to change your view position.
11498
10075
The horizontal scroll bar rotates the plot around the <var>z</var> axis, that
11499
10076
is, to the left and right. The vertical scroll bar rotates the plot
11500
10077
around the <var>y</var> axis, that is, up and down.
11501
10078
11502
<br><p>
10079
<pre class="sp">
10080
10081
</pre>
11503
10082
<div align="center"><img src="PICS/ddd-plots.jpg" alt="PICS/ddd-plots.jpg"></div>
11504
<br><p>
11505
<p>You can also resize the plot window as desired.
10083
<pre class="sp">
10084
10085
</pre>
10086
10087
You can also resize the plot window as desired.
11506
10088
11507
10089
<div class="node">
11508
10090
<p><hr>
11509
<small class=header>
11510
Node:<a name="Scalars%20and%20Composites">Scalars and Composites</a>,
11511
Next:<a rel="next" accesskey="n" href="#Plotting%20Histories">Plotting Histories</a>,
11512
Previous:<a rel="previous" accesskey="p" href="#Plot%20Appearance">Plot Appearance</a>,
11513
Up:<a rel="up" accesskey="u" href="#Plotting%20Values">Plotting Values</a>
10091
<a name="Scalars-and-Composites"></a>
10092
Next: <a rel="next" accesskey="n" href="#Plotting-Histories">Plotting Histories</a>,
10093
Previous: <a rel="previous" accesskey="p" href="#Plot-Appearance">Plot Appearance</a>,
10094
Up: <a rel="up" accesskey="u" href="#Plotting-Values">Plotting Values</a>
11514
10095
</small>
11515
10096
11516
<br>
10097
11517
10098
</div>
11518
10099
11519
<h4 class="subsection">Plotting Scalars and Composites</h4>
10100
<h4 class="subsection">7.4.3 Plotting Scalars and Composites</h4>
11520
10101
11521
<p>Besides plotting arrays, <small>DDD</small> also allows you to plot scalars
11522
(simple numerical values). This works just like plotting arrays--you
11523
select the numerical variable, click on <code>Plot</code>, and here comes the
10102
<p><a name="index-Scalars_002c-plotting-1116"></a>
10103
Besides plotting arrays, <acronym>DDD</acronym> also allows you to plot scalars
10104
(simple numerical values). This works just like plotting arrays—you
10105
select the numerical variable, click on ‘<samp><span class="samp">Plot</span></samp>’, and here comes the
11524
10106
plot. However, plotting a scalar is not very exciting. A plot that
11525
10107
contains nothing but a scalar simply draws the scalar's value as a
11526
<var>y</var> constant--that is, a horizontal line.
10108
<var>y</var> constant—that is, a horizontal line.
11527
10109
11528
<p>So why care about scalars at all? <small>DDD</small> allows you to combine
10110
<p>So why care about scalars at all? <acronym>DDD</acronym> allows you to combine
11529
10111
<em>multiple values into one plot.</em> The basic idea is: if you want to
11530
plot something that is neither an array nor a scalar, <small>DDD</small> takes all
10112
plot something that is neither an array nor a scalar, <acronym>DDD</acronym> takes all
11531
10113
numerical sub-values it can find and plots them all together in one
11532
10114
window. For instance, you can plot all local variables by selecting
11533
<code>Data => Display Local Variables</code>, followed by <code>Plot</code>.
10115
‘<samp><span class="samp">Data Display Local Variables</span></samp>’, followed by ‘<samp><span class="samp">Plot</span></samp>’.
11534
10116
This will create a plot containing all numerical values as found in the
11535
10117
current local variables. Likewise, you can plot all numeric members
11536
contained in a structure by selecting it, followed by <code>Plot</code>.
10118
contained in a structure by selecting it, followed by ‘<samp><span class="samp">Plot</span></samp>’.
11537
10119
11538
<p>If you want more control about what to include in a plot and what not,
10120
<p><a name="index-Cluster_002c-and-plotting-1117"></a>If you want more control about what to include in a plot and what not,
11539
10121
you can use <em>display clusters</em> (see <a href="#Clustering">Clustering</a>). A common
11540
10122
scenario is to plot a one-dimensional array together with the current
11541
10123
index position. This is done in three steps:
11542
10124
11543
10125
<ol type=1 start=1>
11544
<li>Display the array and the index, using <code>Display</code>.
11545
11546
<li>Cluster both displays: select them and choose <code>Undisp =>
11547
Cluster ()</code>.
11548
11549
<li>Plot the cluster by pressing <code>Plot</code>.
10126
<li>Display the array and the index, using ‘<samp><span class="samp">Display</span></samp>’.
10127
10128
<li>Cluster both displays: select them and choose ‘<samp><span class="samp">Undisp
10129
Cluster ()</span></samp>’.
10130
10131
<li>Plot the cluster by pressing ‘<samp><span class="samp">Plot</span></samp>’.
11550
10132
</ol>
11551
10133
11552
10134
<p>Scalars that are displayed together with arrays can be displayed either
11554
10136
as horizontal lines. However, if a scalar is a valid index for an array
11555
10137
that was previously plotted, it is shown as a vertical line. You can
11556
10138
change this initial orientation by selecting the scalar display, followed
11557
by <code>Rotate</code>.
10139
by ‘<samp><span class="samp">Rotate</span></samp>’.
11558
10140
11559
10141
<div class="node">
11560
10142
<p><hr>
11561
<small class=header>
11562
Node:<a name="Plotting%20Histories">Plotting Histories</a>,
11563
Next:<a rel="next" accesskey="n" href="#Printing%20Plots">Printing Plots</a>,
11564
Previous:<a rel="previous" accesskey="p" href="#Scalars%20and%20Composites">Scalars and Composites</a>,
11565
Up:<a rel="up" accesskey="u" href="#Plotting%20Values">Plotting Values</a>
10143
<a name="Plotting-Histories"></a>
10144
Next: <a rel="next" accesskey="n" href="#Printing-Plots">Printing Plots</a>,
10145
Previous: <a rel="previous" accesskey="p" href="#Scalars-and-Composites">Scalars and Composites</a>,
10146
Up: <a rel="up" accesskey="u" href="#Plotting-Values">Plotting Values</a>
11566
10147
</small>
11567
10148
11568
<br>
10149
11569
10150
</div>
11570
10151
11571
<h4 class="subsection">Plotting Display Histories</h4>
10152
<h4 class="subsection">7.4.4 Plotting Display Histories</h4>
11572
10153
11573
<p>At each program stop, <small>DDD</small> records the values of all displayed
11574
variables, such that you can "undo" program execution (see <a href="#Undoing%20Program%20Execution">Undoing Program Execution</a>). These <em>display histories</em> can be plotted,
11575
too. The menu item <code>Plot => Plot history of ()</code> creates a
10154
<p><a name="index-Display_002c-plotting-the-history-1118"></a><a name="index-Value_002c-plotting-the-history-1119"></a><a name="index-History_002c-plotting-1120"></a>
10155
At each program stop, <acronym>DDD</acronym> records the values of all displayed
10156
variables, such that you can “undo” program execution (see <a href="#Undoing-Program-Execution">Undoing Program Execution</a>). These <em>display histories</em> can be plotted,
10157
too. The menu item ‘<samp><span class="samp">Plot Plot history of ()</span></samp>’ creates a
11576
10158
plot that shows all previously recorded values of the selected display.
11577
10159
11578
10160
<div class="node">
11579
10161
<p><hr>
11580
<small class=header>
11581
Node:<a name="Printing%20Plots">Printing Plots</a>,
11582
Next:<a rel="next" accesskey="n" href="#Entering%20Plotting%20Commands">Entering Plotting Commands</a>,
11583
Previous:<a rel="previous" accesskey="p" href="#Plotting%20Histories">Plotting Histories</a>,
11584
Up:<a rel="up" accesskey="u" href="#Plotting%20Values">Plotting Values</a>
10162
<a name="Printing-Plots"></a>
10163
Next: <a rel="next" accesskey="n" href="#Entering-Plotting-Commands">Entering Plotting Commands</a>,
10164
Previous: <a rel="previous" accesskey="p" href="#Plotting-Histories">Plotting Histories</a>,
10165
Up: <a rel="up" accesskey="u" href="#Plotting-Values">Plotting Values</a>
11585
10166
</small>
11586
10167
11587
<br>
10168
11588
10169
</div>
11589
10170
11590
<h4 class="subsection">Printing Plots</h4>
10171
<h4 class="subsection">7.4.5 Printing Plots</h4>
11591
10172
11592
<p>If you want to print the plot, select <code>File => Print Plot</code>.
11593
This pops up the <small>DDD</small> printing dialog, set up for printing plots.
10173
<p><a name="index-Plot_002c-printing-1121"></a><a name="index-Printing-plots-1122"></a><a name="index-Print-Plot-1123"></a>
10174
If you want to print the plot, select ‘<samp><span class="samp">File Print Plot</span></samp>’.
10175
This pops up the <acronym>DDD</acronym> printing dialog, set up for printing plots.
11594
10176
Just as when printing graphs, you have the choice between printing to a
11595
10177
printer or a file and setting up appropriate options.
11596
10178
11598
10180
driver. Please note the following <em>caveats</em> related to printing:
11599
10181
11600
10182
<ul>
11601
<li>Creating <code>FIG</code> files requires an appropriate driver built into
10183
<li>Creating ‘<samp><span class="samp">FIG</span></samp>’ files requires an appropriate driver built into
11602
10184
Gnuplot. Your Gnuplot program may not contain such a driver. In this
11603
10185
case, you will have to recompile Gnuplot, including the line
11604
<code>#define FIG</code> in the Gnuplot <code>term.h</code> file.
10186
‘<samp><span class="samp">#define FIG</span></samp>’ in the Gnuplot ‘<samp><span class="samp">term.h</span></samp>’ file.
11605
10187
11606
<li>The <code>Portrait</code> option generates an <small>EPS</small> file useful for
11607
inclusion in other documents. The <code>Landscape</code> option makes
11608
<small>DDD</small> print the plot in the size specified in the <code>Paper
11609
Size</code> option; this is useful for printing on a printer. In
11610
<code>Portrait</code> mode, the <code>Paper Size</code> option is ignored.
10188
<li><a name="index-Portrait-1124"></a><a name="index-Landscape-1125"></a><a name="index-Paper-Size-1126"></a>The ‘<samp><span class="samp">Portrait</span></samp>’ option generates an <acronym>EPS</acronym> file useful for
10189
inclusion in other documents. The ‘<samp><span class="samp">Landscape</span></samp>’ option makes
10190
<acronym>DDD</acronym> print the plot in the size specified in the ‘<samp><span class="samp">Paper
10191
Size</span></samp>’ option; this is useful for printing on a printer. In
10192
‘<samp><span class="samp">Portrait</span></samp>’ mode, the ‘<samp><span class="samp">Paper Size</span></samp>’ option is ignored.
11611
10193
11612
10194
<li>The Gnuplot device drivers for PostScript and X11 each have their own
11613
10195
set of colors, such that the printed colors may differ from the
11614
10196
displayed colors.
11615
10197
11616
<li>The <code>Selected Only</code> option is set by default, such that only the
10198
<li>The ‘<samp><span class="samp">Selected Only</span></samp>’ option is set by default, such that only the
11617
10199
currently selected plot is printed. (If you select multiple plots to be
11618
10200
printed, the respective outputs will all be concatenated, which may not
11619
10201
be what you desire.)
11620
</ul>
10202
<a name="index-Selected-Only-1127"></a></ul>
11621
10203
11622
10204
<div class="node">
11623
10205
<p><hr>
11624
<small class=header>
11625
Node:<a name="Entering%20Plotting%20Commands">Entering Plotting Commands</a>,
11626
Next:<a rel="next" accesskey="n" href="#Exporting%20Plot%20Data">Exporting Plot Data</a>,
11627
Previous:<a rel="previous" accesskey="p" href="#Printing%20Plots">Printing Plots</a>,
11628
Up:<a rel="up" accesskey="u" href="#Plotting%20Values">Plotting Values</a>
10206
<a name="Entering-Plotting-Commands"></a>
10207
Next: <a rel="next" accesskey="n" href="#Exporting-Plot-Data">Exporting Plot Data</a>,
10208
Previous: <a rel="previous" accesskey="p" href="#Printing-Plots">Printing Plots</a>,
10209
Up: <a rel="up" accesskey="u" href="#Plotting-Values">Plotting Values</a>
11629
10210
</small>
11630
10211
11631
<br>
10212
11632
10213
</div>
11633
10214
11634
<h4 class="subsection">Entering Plotting Commands</h4>
10215
<h4 class="subsection">7.4.6 Entering Plotting Commands</h4>
11635
10216
11636
<p>Via <code>File => Command</code>, you can enter Gnuplot commands
11637
directly. Each command entered at the <code>gnuplot></code> prompt is passed
11638
to Gnuplot, followed by a Gnuplot <code>replot</code> command to update the
10217
<p><a name="index-Command-1128"></a>
10218
Via ‘<samp><span class="samp">File Command</span></samp>’, you can enter Gnuplot commands
10219
directly. Each command entered at the ‘<samp><span class="samp">gnuplot></span></samp>’ prompt is passed
10220
to Gnuplot, followed by a Gnuplot ‘<samp><span class="samp">replot</span></samp>’ command to update the
11639
10221
view. This is useful for advanced Gnuplot tasks.
11640
10222
11641
10223
<p>Here's a simple example. The Gnuplot command
11642
10224
11643
10225
<pre class="example"> set xrange [<var>xmin</var>:<var>xmax</var>]
11644
</pre>
11645
11646
<p>sets the horizontal range that will be displayed to
10226
</pre>
10227
<p class="noindent">sets the horizontal range that will be displayed to
11647
10228
<var>xmin</var><small class="dots">...</small><var>xmax</var>. To plot only the elements 10 to 20, enter:
11648
10229
11649
10230
<pre class="example"> gnuplot> <kbd>set xrange [10:20]</kbd>
11650
10231
gnuplot> _
11651
</pre>
11652
11653
<p>After each command entered, <small>DDD</small> adds a <code>replot</code> command, such
10232
</pre>
10233
<p><a name="index-replot-1129"></a>After each command entered, <acronym>DDD</acronym> adds a <samp><span class="command">replot</span></samp> command, such
11654
10234
that the plot is updated automatically.
11655
10235
11656
10236
<p>Here's a more complex example. The following sequence of Gnuplot
11657
10237
commands saves the plot in TeX format:
11658
10238
10239
<p><a name="index-set-output-1130"></a><a name="index-set-term-1131"></a>
11659
10240
<pre class="example"> gnuplot> <kbd>set output "plot.tex"</kbd> # Set the output filename
11660
10241
gnuplot> <kbd>set term latex</kbd> # Set the output format
11661
10242
gnuplot> <kbd>set term x11</kbd> # Show original picture again
11662
10243
gnuplot> _
11663
</pre>
11664
11665
<p>Due to the implicit <code>replot</code> command, the output is automatically
11666
written to <code>plot.tex</code> after the <code>set term latex</code> command.
10244
</pre>
10245
<p>Due to the implicit <samp><span class="command">replot</span></samp> command, the output is automatically
10246
written to ‘<samp><span class="samp">plot.tex</span></samp>’ after the <samp><span class="command">set term latex</span></samp> command.
11667
10247
11668
10248
<p>The dialog keeps track of the commands entered; use the arrow keys to
11669
10249
restore previous commands. Gnuplot error messages (if any) are also
11670
10250
shown in the history area.
11671
10251
11672
<p>The interaction between <small>DDD</small> and Gnuplot is logged in the file
11673
<code>~/.ddd/log</code> (see <a href="#Logging">Logging</a>). The <small>DDD</small>
11674
<code>--trace</code> option logs this interaction on standard output.
10252
<p><a name="index-log-1132"></a>The interaction between <acronym>DDD</acronym> and Gnuplot is logged in the file
10253
<samp><span class="file">~/.ddd/log</span></samp> (see <a href="#Logging">Logging</a>). The <acronym>DDD</acronym>
10254
<samp><span class="option">--trace</span></samp> option logs this interaction on standard output.
11675
10255
11676
10256
<div class="node">
11677
10257
<p><hr>
11678
<small class=header>
11679
Node:<a name="Exporting%20Plot%20Data">Exporting Plot Data</a>,
11680
Next:<a rel="next" accesskey="n" href="#Animating%20Plots">Animating Plots</a>,
11681
Previous:<a rel="previous" accesskey="p" href="#Entering%20Plotting%20Commands">Entering Plotting Commands</a>,
11682
Up:<a rel="up" accesskey="u" href="#Plotting%20Values">Plotting Values</a>
10258
<a name="Exporting-Plot-Data"></a>
10259
Next: <a rel="next" accesskey="n" href="#Animating-Plots">Animating Plots</a>,
10260
Previous: <a rel="previous" accesskey="p" href="#Entering-Plotting-Commands">Entering Plotting Commands</a>,
10261
Up: <a rel="up" accesskey="u" href="#Plotting-Values">Plotting Values</a>
11683
10262
</small>
11684
10263
11685
<br>
10264
11686
10265
</div>
11687
10266
11688
<h4 class="subsection">Exporting Plot Data</h4>
10267
<h4 class="subsection">7.4.7 Exporting Plot Data</h4>
11689
10268
11690
<p>If you want some external program to process the plot data (a
11691
stand-alone Gnuplot program or the <code>xmgr</code> program, for instance),
11692
you can save the plot data in a file, using <code>File => Save
11693
Data As</code>. This pops up a dialog that lets you choose a data file to
10269
<p><a name="index-Plot_002c-exporting-1133"></a><a name="index-Save-Data-As-1134"></a><a name="index-xmgr-1135"></a>
10270
If you want some external program to process the plot data (a
10271
stand-alone Gnuplot program or the <samp><span class="command">xmgr</span></samp> program, for instance),
10272
you can save the plot data in a file, using ‘<samp><span class="samp">File Save
10273
Data As</span></samp>’. This pops up a dialog that lets you choose a data file to
11694
10274
save the plotted data in.
11695
10275
11696
10276
<p>The generated file starts with a few comment lines. The actual data
11697
10277
follows in X/Y or X/Y/Z format. It is the same file as processed by
11698
10278
Gnuplot.
11699
10279
10280
<!-- Exporting plot data is only available if your plot includes exactly -->
10281
<!-- one array. -->
11700
10282
<div class="node">
11701
10283
<p><hr>
11702
<small class=header>
11703
Node:<a name="Animating%20Plots">Animating Plots</a>,
11704
Next:<a rel="next" accesskey="n" href="#Customizing%20Plots">Customizing Plots</a>,
11705
Previous:<a rel="previous" accesskey="p" href="#Exporting%20Plot%20Data">Exporting Plot Data</a>,
11706
Up:<a rel="up" accesskey="u" href="#Plotting%20Values">Plotting Values</a>
10284
<a name="Animating-Plots"></a>
10285
Next: <a rel="next" accesskey="n" href="#Customizing-Plots">Customizing Plots</a>,
10286
Previous: <a rel="previous" accesskey="p" href="#Exporting-Plot-Data">Exporting Plot Data</a>,
10287
Up: <a rel="up" accesskey="u" href="#Plotting-Values">Plotting Values</a>
11707
10288
</small>
11708
10289
11709
<br>
10290
11710
10291
</div>
11711
10292
11712
<h4 class="subsection">Animating Plots</h4>
10293
<h4 class="subsection">7.4.8 Animating Plots</h4>
11713
10294
11714
<p>If you want to see how your data evolves in time, you can set a
11715
breakpoint whose command sequence ends in a <code>cont</code> command
11716
(see <a href="#Breakpoint%20Commands">Breakpoint Commands</a>. Each time this "continue" breakpoint is
11717
reached, the program stops and <small>DDD</small> updates the displayed values,
11718
including the plots. Then, <small>DDD</small> executes the breakpoint command
10295
<p><a name="index-Plot_002c-animating-1136"></a><a name="index-Animating-plots-1137"></a>
10296
If you want to see how your data evolves in time, you can set a
10297
breakpoint whose command sequence ends in a <samp><span class="command">cont</span></samp> command
10298
(see <a href="#Breakpoint-Commands">Breakpoint Commands</a>. Each time this “continue” breakpoint is
10299
reached, the program stops and <acronym>DDD</acronym> updates the displayed values,
10300
including the plots. Then, <acronym>DDD</acronym> executes the breakpoint command
11719
10301
sequence, resuming execution.
11720
10302
11721
<p>This way, you can set a "continue" breakpoint at some decisive point
11722
within an array-processing algorithm and have <small>DDD</small> display the
10303
<p>This way, you can set a “continue” breakpoint at some decisive point
10304
within an array-processing algorithm and have <acronym>DDD</acronym> display the
11723
10305
progress graphically. When your program has stopped for good, you can
11724
use <code>Undo</code> and <code>Redo</code> to redisplay and examine previous
11725
program states. See <a href="#Undoing%20Program%20Execution">Undoing Program Execution</a>, for details.
10306
use ‘<samp><span class="samp">Undo</span></samp>’ and ‘<samp><span class="samp">Redo</span></samp>’ to redisplay and examine previous
10307
program states. See <a href="#Undoing-Program-Execution">Undoing Program Execution</a>, for details.
11726
10308
11727
10309
<div class="node">
11728
10310
<p><hr>
11729
<small class=header>
11730
Node:<a name="Customizing%20Plots">Customizing Plots</a>,
11731
Previous:<a rel="previous" accesskey="p" href="#Animating%20Plots">Animating Plots</a>,
11732
Up:<a rel="up" accesskey="u" href="#Plotting%20Values">Plotting Values</a>
10311
<a name="Customizing-Plots"></a>
10312
Previous: <a rel="previous" accesskey="p" href="#Animating-Plots">Animating Plots</a>,
10313
Up: <a rel="up" accesskey="u" href="#Plotting-Values">Plotting Values</a>
11733
10314
</small>
11734
10315
11735
<br>
10316
11736
10317
</div>
11737
10318
11738
<h4 class="subsection">Customizing Plots</h4>
10319
<h4 class="subsection">7.4.9 Customizing Plots</h4>
11739
10320
11740
<p>You can customize the Gnuplot program to invoke, as well as a number of
10321
<p>You can customize the Gnuplot program to invoke, as well as a number of
11741
10322
basic settings.
11742
10323
11743
10324
<ul class="menu">
11744
<li><a accesskey="1" href="#Gnuplot%20Invocation">Gnuplot Invocation</a>:
11745
<li><a accesskey="2" href="#Gnuplot%20Settings">Gnuplot Settings</a>:
10325
<li><a accesskey="1" href="#Gnuplot-Invocation">Gnuplot Invocation</a>
10326
<li><a accesskey="2" href="#Gnuplot-Settings">Gnuplot Settings</a>
11746
10327
</ul>
11747
10328
11748
10329
<div class="node">
11749
10330
<p><hr>
11750
<small class=header>
11751
Node:<a name="Gnuplot%20Invocation">Gnuplot Invocation</a>,
11752
Next:<a rel="next" accesskey="n" href="#Gnuplot%20Settings">Gnuplot Settings</a>,
11753
Up:<a rel="up" accesskey="u" href="#Customizing%20Plots">Customizing Plots</a>
10331
<a name="Gnuplot-Invocation"></a>
10332
Next: <a rel="next" accesskey="n" href="#Gnuplot-Settings">Gnuplot Settings</a>,
10333
Up: <a rel="up" accesskey="u" href="#Customizing-Plots">Customizing Plots</a>
11754
10334
</small>
11755
10335
11756
<br>
10336
11757
10337
</div>
11758
10338
11759
<h5 class="subsubsection">Gnuplot Invocation</h5>
10339
<h5 class="subsubsection">7.4.9.1 Gnuplot Invocation</h5>
11760
10340
11761
<p>Using <code>Edit => Preferences => Helpers =>
11762
Plot</code>, you can choose the Gnuplot program to invoke. This is tied to
10341
<p><a name="index-Plot-1138"></a>Using ‘<samp><span class="samp">Edit Preferences Helpers
10342
Plot</span></samp>’, you can choose the Gnuplot program to invoke. This is tied to
11763
10343
the following resource:
11764
10344
11765
<p>
11766
<table width="100%">
11767
<tr>
11768
<td align="left"><b>plotCommand</b><i> </i>(<i>class PlotCommand</i>)<i>
11769
</i></td>
11770
<td align="right">Resource</td>
11771
</tr>
11772
</table>
11773
<table width="95%" align="center">
11774
<tr><td>
11775
The name of a Gnuplot executable. Default is <code>gnuplot</code>,
10345
<div class="defun">
10346
— Resource: <b>plotCommand</b> (<var>class PlotCommand</var>)<var><a name="index-plotCommand-1139"></a></var><br>
10347
<blockquote><p>The name of a Gnuplot executable. Default is ‘<samp><span class="samp">gnuplot</span></samp>’,
11776
10348
followed by some options to set up colors and the initial geometry.
11777
</td></tr>
11778
</table>
11779
11780
<p>Using <code>Edit => Preferences => Helpers => Plot
11781
Window</code>, you can choose whether to use the Gnuplot plot window
11782
(<code>External</code>) or to use the plot window supplied by <small>DDD</small>
11783
(<code>builtin</code>). This is tied to the following resource:
11784
11785
<p>
11786
<table width="100%">
11787
<tr>
11788
<td align="left"><b>plotTermType</b><i> </i>(<i>class PlotTermType</i>)<i>
11789
</i></td>
11790
<td align="right">Resource</td>
11791
</tr>
11792
</table>
11793
<table width="95%" align="center">
11794
<tr><td>
11795
The Gnuplot terminal type. Can have one of two values:
10349
</p></blockquote></div>
10350
10351
<p><a name="index-Plot-Window-1140"></a>Using ‘<samp><span class="samp">Edit Preferences Helpers Plot
10352
Window</span></samp>’, you can choose whether to use the Gnuplot plot window
10353
(‘<samp><span class="samp">External</span></samp>’) or to use the plot window supplied by <acronym>DDD</acronym>
10354
(‘<samp><span class="samp">builtin</span></samp>’). This is tied to the following resource:
10355
10356
<div class="defun">
10357
— Resource: <b>plotTermType</b> (<var>class PlotTermType</var>)<var><a name="index-plotTermType-1141"></a></var><br>
10358
<blockquote><p>The Gnuplot terminal type. Can have one of two values:
11796
10359
<ul>
11797
<li>If this is <code>x11</code>, <small>DDD</small> "swallows" the <em>external</em>
10360
<li><a name="index-mwm-1142"></a>If this is ‘<samp><span class="samp">x11</span></samp>’, <acronym>DDD</acronym> “swallows” the <em>external</em>
11798
10361
Gnuplot output window into its own user interface. Some window
11799
managers, notably <code>mwm</code>, have trouble with swallowing techniques.
11800
<li>Setting this resource to <code>xlib</code> (default) makes <small>DDD</small>
10362
managers, notably <samp><span class="command">mwm</span></samp>, have trouble with swallowing techniques.
10363
<li>Setting this resource to ‘<samp><span class="samp">xlib</span></samp>’ (default) makes <acronym>DDD</acronym>
11801
10364
provide a <em>builtin plot window</em> instead. In this mode, plots work
11802
10365
well with any window manager, but are less customizable (Gnuplot
11803
10366
resources are not understood).
11804
10367
</ul>
11805
</td></tr>
11806
</table>
10368
</p></blockquote></div>
11807
10369
11808
10370
<p>You can further control interaction with the external plot window:
11809
10371
11810
<p>
11811
<table width="100%">
11812
<tr>
11813
<td align="left"><b>plotWindowClass</b><i> </i>(<i>class PlotWindowClass</i>)<i>
11814
</i></td>
11815
<td align="right">Resource</td>
11816
</tr>
11817
</table>
11818
<table width="95%" align="center">
11819
<tr><td>
11820
The class of the Gnuplot output window. When invoking Gnuplot,
11821
<small>DDD</small> waits for a window with this class and incorporates it into
11822
its own user interface (unless <code>plotTermType</code> is <code>xlib</code>; see
11823
above). Default is <code>Gnuplot</code>.
11824
</td></tr>
11825
</table>
10372
<div class="defun">
10373
— Resource: <b>plotWindowClass</b> (<var>class PlotWindowClass</var>)<var><a name="index-plotWindowClass-1143"></a></var><br>
10374
<blockquote><p>The class of the Gnuplot output window. When invoking Gnuplot,
10375
<acronym>DDD</acronym> waits for a window with this class and incorporates it into
10376
its own user interface (unless ‘<samp><span class="samp">plotTermType</span></samp>’ is ‘<samp><span class="samp">xlib</span></samp>’; see
10377
above). Default is ‘<samp><span class="samp">Gnuplot</span></samp>’.
10378
</p></blockquote></div>
11826
10379
11827
<p>
11828
<table width="100%">
11829
<tr>
11830
<td align="left"><b>plotWindowDelay</b><i> </i>(<i>class WindowDelay</i>)<i>
11831
</i></td>
11832
<td align="right">Resource</td>
11833
</tr>
11834
</table>
11835
<table width="95%" align="center">
11836
<tr><td>
11837
The time (in ms) to wait for the creation of the Gnuplot window. Before
11838
this delay, <small>DDD</small> looks at each newly created window to see
10380
<div class="defun">
10381
— Resource: <b>plotWindowDelay</b> (<var>class WindowDelay</var>)<var><a name="index-plotWindowDelay-1144"></a></var><br>
10382
<blockquote><p>The time (in ms) to wait for the creation of the Gnuplot window. Before
10383
this delay, <acronym>DDD</acronym> looks at each newly created window to see
11839
10384
whether this is the plot window to swallow. This is cheap, but
11840
10385
unfortunately, some window managers do not pass the creation event to
11841
<small>DDD</small>. If this delay has passed, and <small>DDD</small> has not found
11842
the plot window, <small>DDD</small> searches <em>all</em> existing windows, which
10386
<acronym>DDD</acronym>. If this delay has passed, and <acronym>DDD</acronym> has not found
10387
the plot window, <acronym>DDD</acronym> searches <em>all</em> existing windows, which
11843
10388
is pretty expensive. Default time is <code>2000</code>.
11844
</td></tr>
11845
</table>
10389
</p></blockquote></div>
11846
10390
11847
10391
<div class="node">
11848
10392
<p><hr>
11849
<small class=header>
11850
Node:<a name="Gnuplot%20Settings">Gnuplot Settings</a>,
11851
Previous:<a rel="previous" accesskey="p" href="#Gnuplot%20Invocation">Gnuplot Invocation</a>,
11852
Up:<a rel="up" accesskey="u" href="#Customizing%20Plots">Customizing Plots</a>
10393
<a name="Gnuplot-Settings"></a>
10394
Previous: <a rel="previous" accesskey="p" href="#Gnuplot-Invocation">Gnuplot Invocation</a>,
10395
Up: <a rel="up" accesskey="u" href="#Customizing-Plots">Customizing Plots</a>
11853
10396
</small>
11854
10397
11855
<br>
10398
11856
10399
</div>
11857
10400
11858
<h5 class="subsubsection">Gnuplot Settings</h5>
11859
11860
<p>To change Gnuplot settings, use these resources:
11861
11862
<p>
11863
<table width="100%">
11864
<tr>
11865
<td align="left"><b>plotInitCommands</b><i> </i>(<i>class PlotInitCommands</i>)<i>
11866
</i></td>
11867
<td align="right">Resource</td>
11868
</tr>
11869
</table>
11870
<table width="95%" align="center">
11871
<tr><td>
11872
The initial Gnuplot commands issued by <small>DDD</small>. Default is:
10401
<h5 class="subsubsection">7.4.9.2 Gnuplot Settings</h5>
10402
10403
<p>To change Gnuplot settings, use these resources:
10404
10405
<div class="defun">
10406
— Resource: <b>plotInitCommands</b> (<var>class PlotInitCommands</var>)<var><a name="index-plotInitCommands-1145"></a></var><br>
10407
<blockquote><p>The initial Gnuplot commands issued by <acronym>DDD</acronym>. Default is:
11873
10408
11874
10409
<pre class="example"> set parametric
11875
10410
set urange [0:1]
11876
10411
set vrange [0:1]
11877
10412
set trange [0:1]
11878
</pre>
11879
11880
<p>The <code>parametric</code> setting is required to make Gnuplot understand the
11881
data files as generated <small>DDD</small>. The range commands are used to
10413
</pre>
10414
<p>The ‘<samp><span class="samp">parametric</span></samp>’ setting is required to make Gnuplot understand the
10415
data files as generated <acronym>DDD</acronym>. The range commands are used to
11882
10416
plot scalars.
11883
</td></tr>
11884
</table>
10417
</p></blockquote></div>
11885
10418
11886
10419
<p>See the Gnuplot documentation for additional commands.
11887
10420
11888
<p>
11889
<table width="100%">
11890
<tr>
11891
<td align="left"><b>plot2dSettings</b><i> </i>(<i>class PlotSettings</i>)<i>
11892
</i></td>
11893
<td align="right">Resource</td>
11894
</tr>
11895
</table>
11896
<table width="95%" align="center">
11897
<tr><td>
11898
Additional initial settings for 2-D plots. Default is <code>set
11899
noborder</code>. Feel free to customize these settings as desired.
11900
</td></tr>
11901
</table>
10421
<div class="defun">
10422
— Resource: <b>plot2dSettings</b> (<var>class PlotSettings</var>)<var><a name="index-plot2dSettings-1146"></a></var><br>
10423
<blockquote><p>Additional initial settings for 2-D plots. Default is ‘<samp><span class="samp">set
10424
noborder</span></samp>’. Feel free to customize these settings as desired.
10425
</p></blockquote></div>
11902
10426
11903
<p>
11904
<table width="100%">
11905
<tr>
11906
<td align="left"><b>plot3dSettings</b><i> </i>(<i>class PlotSettings</i>)<i>
11907
</i></td>
11908
<td align="right">Resource</td>
11909
</tr>
11910
</table>
11911
<table width="95%" align="center">
11912
<tr><td>
11913
Additional initial settings for 3-D plots. Default is <code>set
11914
border</code>. Feel free to customize these settings as desired.
11915
</td></tr>
11916
</table>
10427
<div class="defun">
10428
— Resource: <b>plot3dSettings</b> (<var>class PlotSettings</var>)<var><a name="index-plot3dSettings-1147"></a></var><br>
10429
<blockquote><p>Additional initial settings for 3-D plots. Default is ‘<samp><span class="samp">set
10430
border</span></samp>’. Feel free to customize these settings as desired.
10431
</p></blockquote></div>
11917
10432
11918
10433
<div class="node">
11919
10434
<p><hr>
11920
<small class=header>
11921
Node:<a name="Examining%20Memory">Examining Memory</a>,
11922
Previous:<a rel="previous" accesskey="p" href="#Plotting%20Values">Plotting Values</a>,
11923
Up:<a rel="up" accesskey="u" href="#Examining%20Data">Examining Data</a>
10435
<a name="Examining-Memory"></a>
10436
Previous: <a rel="previous" accesskey="p" href="#Plotting-Values">Plotting Values</a>,
10437
Up: <a rel="up" accesskey="u" href="#Examining-Data">Examining Data</a>
11924
10438
</small>
11925
10439
11926
<br>
10440
11927
10441
</div>
11928
10442
11929
<h3 class="section">Examining Memory</h3>
10443
<h3 class="section">7.5 Examining Memory</h3>
11930
10444
11931
<p>Using <small>GDB</small> or <small>DBX</small>, you can examine memory in any of several
10445
<p><a name="index-Examining-memory-contents-1148"></a><a name="index-Memory_002c-examining-1149"></a>
10446
<a name="index-Memory-1150"></a>Using <acronym>GDB</acronym> or <acronym>DBX</acronym>, you can examine memory in any of several
11932
10447
formats, independently of your program's data types. The item
11933
<code>Data => Memory</code> pops up a panel where you can choose the
10448
‘<samp><span class="samp">Data Memory</span></samp>’ pops up a panel where you can choose the
11934
10449
format to be shown.
11935
10450
11936
<br><p>
10451
<pre class="sp">
10452
10453
</pre>
11937
10454
<div align="center"><img src="PICS/ddd-examine.jpg" alt="PICS/ddd-examine.jpg"></div>
11938
<br><p>
11939
<p>In the panel, you can enter
10455
<pre class="sp">
10456
10457
</pre>
10458
10459
In the panel, you can enter
11940
10460
11941
10461
<ul>
11942
10462
<li>a <dfn>repeat count</dfn>, a decimal integer that specifies how much memory
11943
10463
(counting by units) to display
11944
10464
11945
<li>a <dfn>display format</dfn>--one of
10465
<li>a <dfn>display format</dfn>—one of
11946
10466
11947
10467
<dl>
11948
<dt><code>octal</code>
11949
<dd>Print as integer in octal
10468
<dt>‘<samp><span class="samp">octal</span></samp>’<dd>Print as integer in octal
11950
10469
11951
<br><dt><code>hex</code>
11952
<dd>Regard the bits of the value as an integer, and print the integer
10470
<br><dt>‘<samp><span class="samp">hex</span></samp>’<dd>Regard the bits of the value as an integer, and print the integer
11953
10471
in hexadecimal.
11954
10472
11955
<br><dt><code>decimal</code>
11956
<dd>Print as integer in signed decimal.
11957
11958
<br><dt><code>unsigned</code>
11959
<dd>Print as integer in unsigned decimal.
11960
11961
<br><dt><code>binary</code>
11962
<dd>Print as integer in binary.
11963
11964
<br><dt><code>float</code>
11965
<dd>Regard the bits of the value as a floating point number and print
10473
<br><dt>‘<samp><span class="samp">decimal</span></samp>’<dd>Print as integer in signed decimal.
10474
10475
<br><dt>‘<samp><span class="samp">unsigned</span></samp>’<dd>Print as integer in unsigned decimal.
10476
10477
<br><dt>‘<samp><span class="samp">binary</span></samp>’<dd>Print as integer in binary.
10478
10479
<br><dt>‘<samp><span class="samp">float</span></samp>’<dd>Regard the bits of the value as a floating point number and print
11966
10480
using typical floating point syntax.
11967
10481
11968
<br><dt><code>address</code>
11969
<dd>Print as an address, both absolute in hexadecimal and as an offset
10482
<br><dt>‘<samp><span class="samp">address</span></samp>’<dd>Print as an address, both absolute in hexadecimal and as an offset
11970
10483
from the nearest preceding symbol.
11971
10484
11972
<br><dt><code>instruction</code>
11973
<dd>Print as machine instructions. The unit size is ignored for this
10485
<br><dt>‘<samp><span class="samp">instruction</span></samp>’<dd>Print as machine instructions. The unit size is ignored for this
11974
10486
display format.
11975
10487
11976
<br><dt><code>char</code>
11977
<dd>Regard as an integer and print it as a character constant.
10488
<br><dt>‘<samp><span class="samp">char</span></samp>’<dd>Regard as an integer and print it as a character constant.
11978
10489
11979
<br><dt><code>string</code>
11980
<dd>Print as null-terminated string. The unit size is ignored for this
10490
<br><dt>‘<samp><span class="samp">string</span></samp>’<dd>Print as null-terminated string. The unit size is ignored for this
11981
10491
display format.
11982
10492
</dl>
11983
10493
11984
<li>a <dfn>unit size</dfn>--one of
10494
<li>a <dfn>unit size</dfn>—one of
11985
10495
11986
10496
<dl>
11987
<dt><code>bytes</code>
11988
<dd>Bytes.
11989
11990
<br><dt><code>halfwords</code>
11991
<dd>Halfwords (two bytes).
11992
11993
<br><dt><code>words</code>
11994
<dd>Words (four bytes).
11995
11996
<br><dt><code>giants</code>
11997
<dd>Giant words (eight bytes).
10497
<dt>‘<samp><span class="samp">bytes</span></samp>’<dd>Bytes.
10498
10499
<br><dt>‘<samp><span class="samp">halfwords</span></samp>’<dd>Halfwords (two bytes).
10500
10501
<br><dt>‘<samp><span class="samp">words</span></samp>’<dd>Words (four bytes).
10502
10503
<br><dt>‘<samp><span class="samp">giants</span></samp>’<dd>Giant words (eight bytes).
11998
10504
</dl>
11999
10505
12000
<li>an <dfn>address</dfn>--the starting display address. The expression need
10506
<li>an <dfn>address</dfn>—the starting display address. The expression need
12001
10507
not have a pointer value (though it may); it is always interpreted as an
12002
10508
integer address of a byte of memory.
12003
10509
</ul>
12005
10511
<p>There are two ways to examine the values:
12006
10512
12007
10513
<ul>
12008
<li>You can dump the memory in the debugger console (using <code>Print</code>).
12009
If you repeat the resulting <code>x</code> command by pressing <Return> in
12010
the debugger console (see <a href="#Command%20History">Command History</a>), the following area of
10514
<li>You can dump the memory in the debugger console (using ‘<samp><span class="samp">Print</span></samp>’).
10515
If you repeat the resulting ‘<samp><span class="samp">x</span></samp>’ command by pressing <Return> in
10516
the debugger console (see <a href="#Command-History">Command History</a>), the following area of
12011
10517
memory is shown.
12012
10518
12013
10519
<li>You can also display the memory dump in the data window (using
12014
<code>Display</code>). If you choose to display the values, the values will
10520
‘<samp><span class="samp">Display</span></samp>’). If you choose to display the values, the values will
12015
10521
be updated automatically each time the program stop.
12016
10522
</ul>
12017
10523
12018
10524
<div class="node">
12019
10525
<p><hr>
12020
<small class=header>
12021
Node:<a name="Machine-Level%20Debugging">Machine-Level Debugging</a>,
12022
Next:<a rel="next" accesskey="n" href="#Changing%20the%20Program">Changing the Program</a>,
12023
Previous:<a rel="previous" accesskey="p" href="#Examining%20Data">Examining Data</a>,
12024
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
10526
<a name="Machine-Level-Debugging"></a>
10527
<a name="Machine_002dLevel-Debugging"></a>
10528
Next: <a rel="next" accesskey="n" href="#Changing-the-Program">Changing the Program</a>,
10529
Previous: <a rel="previous" accesskey="p" href="#Examining-Data">Examining Data</a>,
10530
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
12025
10531
</small>
12026
10532
12027
<br>
10533
12028
10534
</div>
12029
10535
12030
<h2 class="chapter">Machine-Level Debugging</h2>
10536
<h2 class="chapter">8 Machine-Level Debugging</h2>
12031
10537
12032
<p>Sometimes, it is desirable to examine a program not only at the source
12033
level, but also at the machine level. <small>DDD</small> provides special
10538
<p>Sometimes, it is desirable to examine a program not only at the source
10539
level, but also at the machine level. <acronym>DDD</acronym> provides special
12034
10540
machine code and register windows for this task.
12035
10541
12036
10542
<ul class="menu">
12037
<li><a accesskey="1" href="#Machine%20Code">Machine Code</a>: Examining machine code.
12038
<li><a accesskey="2" href="#Machine%20Code%20Execution">Machine Code Execution</a>: Stepping across instructions.
10543
<li><a accesskey="1" href="#Machine-Code">Machine Code</a>: Examining machine code.
10544
<li><a accesskey="2" href="#Machine-Code-Execution">Machine Code Execution</a>: Stepping across instructions.
12039
10545
<li><a accesskey="3" href="#Registers">Registers</a>: Examining registers.
12040
<li><a accesskey="4" href="#Customizing%20Machine%20Code">Customizing Machine Code</a>: Settings.
10546
<li><a accesskey="4" href="#Customizing-Machine-Code">Customizing Machine Code</a>: Settings.
12041
10547
</ul>
12042
10548
12043
10549
<div class="node">
12044
10550
<p><hr>
12045
<small class=header>
12046
Node:<a name="Machine%20Code">Machine Code</a>,
12047
Next:<a rel="next" accesskey="n" href="#Machine%20Code%20Execution">Machine Code Execution</a>,
12048
Up:<a rel="up" accesskey="u" href="#Machine-Level%20Debugging">Machine-Level Debugging</a>
10551
<a name="Machine-Code"></a>
10552
Next: <a rel="next" accesskey="n" href="#Machine-Code-Execution">Machine Code Execution</a>,
10553
Up: <a rel="up" accesskey="u" href="#Machine_002dLevel-Debugging">Machine-Level Debugging</a>
12049
10554
</small>
12050
10555
12051
<br>
10556
12052
10557
</div>
12053
10558
12054
<h3 class="section">Examining Machine Code</h3>
10559
<h3 class="section">8.1 Examining Machine Code</h3>
12055
10560
12056
<p>To enable machine-level support, select <code>Source => Display
12057
Machine Code</code>. With machine code enabled, an additional <em>machine
10561
<p><a name="index-Machine-code_002c-examining-1151"></a>
10562
To enable machine-level support, select ‘<samp><span class="samp">Source Display
10563
Machine Code</span></samp>’. With machine code enabled, an additional <em>machine
12058
10564
code window</em> shows up, displaying the machine code of the current
12059
function.<a rel="footnote" href="#fn-30"><sup>30</sup></a> By moving the sash at the right of the
10565
function.<a rel="footnote" href="#fn-30" name="fnd-30"><sup>30</sup></a> By moving the sash at the right of the
12060
10566
separating line between source and machine code, you can resize the
12061
10567
source and machine code windows.
12062
10568
12063
<br><p>
10569
<pre class="sp">
10570
10571
</pre>
12064
10572
<div align="center"><img src="PICS/ddd-code.jpg" alt="PICS/ddd-code.jpg"></div>
12065
<br><p>
12066
<p>The machine code window works very much like the source window. You can
10573
<pre class="sp">
10574
10575
</pre>
10576
10577
The machine code window works very much like the source window. You can
12067
10578
set, clear, and change breakpoints by selecting the address and pressing
12068
a <code>Break</code> or <code>Clear</code> button; the usual popup menus are also
10579
a ‘<samp><span class="samp">Break</span></samp>’ or ‘<samp><span class="samp">Clear</span></samp>’ button; the usual popup menus are also
12069
10580
available. Breakpoints and the current execution position are displayed
12070
10581
simultaneously in both source and machine code.
12071
10582
12072
<p>The <code>Lookup</code> button can be used to look up the machine code for a
12073
specific function--or the function for a specific address. Just click
12074
on the location in one window and press <code>Lookup</code> to see the
10583
<p>The ‘<samp><span class="samp">Lookup</span></samp>’ button can be used to look up the machine code for a
10584
specific function—or the function for a specific address. Just click
10585
on the location in one window and press ‘<samp><span class="samp">Lookup</span></samp>’ to see the
12075
10586
corresponding code in the other window.
12076
10587
12077
10588
<p>If source code is not available, only the machine code window is
12078
10589
updated.
12079
10590
12080
10591
<p>You can customize various aspects of the disassembling window.
12081
See <a href="#Customizing%20Machine%20Code">Customizing Machine Code</a>, for details.
10592
See <a href="#Customizing-Machine-Code">Customizing Machine Code</a>, for details.
12082
10593
12083
10594
<div class="node">
12084
10595
<p><hr>
12085
<small class=header>
12086
Node:<a name="Machine%20Code%20Execution">Machine Code Execution</a>,
12087
Next:<a rel="next" accesskey="n" href="#Registers">Registers</a>,
12088
Previous:<a rel="previous" accesskey="p" href="#Machine%20Code">Machine Code</a>,
12089
Up:<a rel="up" accesskey="u" href="#Machine-Level%20Debugging">Machine-Level Debugging</a>
10596
<a name="Machine-Code-Execution"></a>
10597
Next: <a rel="next" accesskey="n" href="#Registers">Registers</a>,
10598
Previous: <a rel="previous" accesskey="p" href="#Machine-Code">Machine Code</a>,
10599
Up: <a rel="up" accesskey="u" href="#Machine_002dLevel-Debugging">Machine-Level Debugging</a>
12090
10600
</small>
12091
10601
12092
<br>
10602
12093
10603
</div>
12094
10604
12095
<h3 class="section">Machine Code Execution</h3>
10605
<h3 class="section">8.2 Machine Code Execution</h3>
12096
10606
12097
<p>All execution facilities available in the source code window are
10607
<p><a name="index-Machine-code_002c-executing-1152"></a>
10608
All execution facilities available in the source code window are
12098
10609
available in the machine code window as well. Two special facilities
12099
10610
are convenient for machine-level debugging:
12100
10611
12101
<p>To execute just one machine instruction, click on the <code>Stepi</code>
12102
button or select <code>Program => Step Instruction</code>.
10612
<p><a name="index-Stepi-1153"></a><a name="index-Step-Instruction-1154"></a><a name="index-Instruction_002c-stepping-1155"></a>To execute just one machine instruction, click on the ‘<samp><span class="samp">Stepi</span></samp>’
10613
button or select ‘<samp><span class="samp">Program Step Instruction</span></samp>’.
12103
10614
12104
<p>To continue to the next instruction in the current function, click on
12105
the <code>Nexti</code> button select <code>Program => Next
12106
Instruction</code>.. This is similar to <code>Stepi</code>, but any subroutine
10615
<p><a name="index-Nexti-1156"></a><a name="index-Next-Instruction-1157"></a>To continue to the next instruction in the current function, click on
10616
the ‘<samp><span class="samp">Nexti</span></samp>’ button select ‘<samp><span class="samp">Program Next
10617
Instruction</span></samp>’.. This is similar to ‘<samp><span class="samp">Stepi</span></samp>’, but any subroutine
12107
10618
calls are executed without stopping.
12108
10619
12109
<p>Using <small>GDB</small>, it is often useful to do
10620
<p><a name="index-Program-counter_002c-displaying-1158"></a>Using <acronym>GDB</acronym>, it is often useful to do
12110
10621
12111
10622
<pre class="example"> graph display /i $pc
12112
</pre>
12113
12114
<p>when stepping by machine instructions. This makes <small>DDD</small>
10623
</pre>
10624
<p class="noindent">when stepping by machine instructions. This makes <acronym>DDD</acronym>
12115
10625
automatically display the next instruction to be executed, each time
12116
10626
your program stops.
12117
10627
12118
10628
<div class="node">
12119
10629
<p><hr>
12120
<small class=header>
12121
Node:<a name="Registers">Registers</a>,
12122
Next:<a rel="next" accesskey="n" href="#Customizing%20Machine%20Code">Customizing Machine Code</a>,
12123
Previous:<a rel="previous" accesskey="p" href="#Machine%20Code%20Execution">Machine Code Execution</a>,
12124
Up:<a rel="up" accesskey="u" href="#Machine-Level%20Debugging">Machine-Level Debugging</a>
10630
<a name="Registers"></a>
10631
Next: <a rel="next" accesskey="n" href="#Customizing-Machine-Code">Customizing Machine Code</a>,
10632
Previous: <a rel="previous" accesskey="p" href="#Machine-Code-Execution">Machine Code Execution</a>,
10633
Up: <a rel="up" accesskey="u" href="#Machine_002dLevel-Debugging">Machine-Level Debugging</a>
12125
10634
</small>
12126
10635
12127
<br>
10636
12128
10637
</div>
12129
10638
12130
<h3 class="section">Examining Registers</h3>
10639
<h3 class="section">8.3 Examining Registers</h3>
12131
10640
12132
<p><small>DDD</small> provides a <em>register window</em> showing the machine
10641
<p><a name="index-Registers_002c-examining-1159"></a>
10642
<a name="index-Registers-1160"></a><acronym>DDD</acronym> provides a <em>register window</em> showing the machine
12133
10643
register values after each program stop. To enable the register window,
12134
select <code>Status => Registers</code>.<a rel="footnote" href="#fn-31"><sup>31</sup></a>
12135
12136
<br><p>
10644
select ‘<samp><span class="samp">Status Registers</span></samp>’.<a rel="footnote" href="#fn-31" name="fnd-31"><sup>31</sup></a>
10645
10646
<pre class="sp">
10647
10648
</pre>
12137
10649
<div align="center"><img src="PICS/ddd-registers.jpg" alt="PICS/ddd-registers.jpg"></div>
12138
<br><p>
12139
<p>By selecting one of the registers, its name is copied to the argument
12140
field. You can use it as value for <code>Display</code>, for instance, to
10650
<pre class="sp">
10651
10652
</pre>
10653
10654
By selecting one of the registers, its name is copied to the argument
10655
field. You can use it as value for ‘<samp><span class="samp">Display</span></samp>’, for instance, to
12141
10656
have its value displayed in the data window.
12142
10657
12143
10658
<div class="node">
12144
10659
<p><hr>
12145
<small class=header>
12146
Node:<a name="Customizing%20Machine%20Code">Customizing Machine Code</a>,
12147
Previous:<a rel="previous" accesskey="p" href="#Registers">Registers</a>,
12148
Up:<a rel="up" accesskey="u" href="#Machine-Level%20Debugging">Machine-Level Debugging</a>
10660
<a name="Customizing-Machine-Code"></a>
10661
Previous: <a rel="previous" accesskey="p" href="#Registers">Registers</a>,
10662
Up: <a rel="up" accesskey="u" href="#Machine_002dLevel-Debugging">Machine-Level Debugging</a>
12149
10663
</small>
12150
10664
12151
<br>
10665
12152
10666
</div>
12153
10667
12154
<h3 class="section">Customizing Machine Code</h3>
12155
12156
<p>Enabling machine code via <code>Source => Display Machine Code</code>
12157
(see <a href="#Machine%20Code">Machine Code</a>) toggles the following resource:
12158
12159
<p>
12160
<table width="100%">
12161
<tr>
12162
<td align="left"><b>disassemble</b><i> </i>(<i>class Disassemble</i>)<i>
12163
</i></td>
12164
<td align="right">Resource</td>
12165
</tr>
12166
</table>
12167
<table width="95%" align="center">
12168
<tr><td>
12169
If this is <code>on</code>, the source code is automatically disassembled.
12170
The default is <code>off</code>. See <a href="#Options">Options</a>, for the <code>--disassemble</code>
12171
and <code>--no-disassemble</code> options.
12172
</td></tr>
12173
</table>
12174
12175
<p>You can keep disassembled code in memory, using <code>Edit =>
12176
Preferences => Source => Cache Machine Code</code>:
12177
12178
<p>
12179
<table width="100%">
12180
<tr>
12181
<td align="left"><b>cacheMachineCode</b><i> </i>(<i>class CacheMachineCode</i>)<i>
12182
</i></td>
12183
<td align="right">Resource</td>
12184
</tr>
12185
</table>
12186
<table width="95%" align="center">
12187
<tr><td>
12188
Whether to cache disassembled machine code (<code>on</code>, default) or
12189
not (<code>off</code>). Caching machine code requires more memory, but
12190
makes <small>DDD</small> run faster.
12191
</td></tr>
12192
</table>
12193
12194
<p>You can control the indentation of machine code, using <code>Edit
12195
=> Preferences => Source => Machine Code
12196
Indentation</code>:
12197
12198
<p>
12199
<table width="100%">
12200
<tr>
12201
<td align="left"><b>indentCode</b><i> </i>(<i>class Indent</i>)<i>
12202
</i></td>
12203
<td align="right">Resource</td>
12204
</tr>
12205
</table>
12206
<table width="95%" align="center">
12207
<tr><td>
12208
The number of columns to indent the machine code, such that there is
10668
<h3 class="section">8.4 Customizing Machine Code</h3>
10669
10670
<p>Enabling machine code via ‘<samp><span class="samp">Source Display Machine Code</span></samp>’
10671
(see <a href="#Machine-Code">Machine Code</a>) toggles the following resource:
10672
10673
<div class="defun">
10674
— Resource: <b>disassemble</b> (<var>class Disassemble</var>)<var><a name="index-disassemble-1161"></a></var><br>
10675
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’, the source code is automatically disassembled.
10676
The default is ‘<samp><span class="samp">off</span></samp>’. See <a href="#Options">Options</a>, for the <samp><span class="option">--disassemble</span></samp>
10677
and <samp><span class="option">--no-disassemble</span></samp> options.
10678
</p></blockquote></div>
10679
10680
<p><a name="index-Cache-Machine-Code-1162"></a>You can keep disassembled code in memory, using ‘<samp><span class="samp">Edit
10681
Preferences Source Cache Machine Code</span></samp>’:
10682
10683
<div class="defun">
10684
— Resource: <b>cacheMachineCode</b> (<var>class CacheMachineCode</var>)<var><a name="index-cacheMachineCode-1163"></a></var><br>
10685
<blockquote><p>Whether to cache disassembled machine code (‘<samp><span class="samp">on</span></samp>’, default) or
10686
not (‘<samp><span class="samp">off</span></samp>’). Caching machine code requires more memory, but
10687
makes <acronym>DDD</acronym> run faster.
10688
</p></blockquote></div>
10689
10690
<p><a name="index-Machine-Code-Indentation-1164"></a>You can control the indentation of machine code, using ‘<samp><span class="samp">Edit
10691
Preferences Source Machine Code
10692
Indentation</span></samp>’:
10693
10694
<div class="defun">
10695
— Resource: <b>indentCode</b> (<var>class Indent</var>)<var><a name="index-indentCode-1165"></a></var><br>
10696
<blockquote><p>The number of columns to indent the machine code, such that there is
12209
10697
enough place to display breakpoint locations. Default: <code>4</code>.
12210
</td></tr>
12211
</table>
10698
</p></blockquote></div>
12212
10699
12213
<p>The <code>maxDisassemble</code> resource controls how much is to be
12214
disassembled. If <code>maxDisassemble</code> is set to 256 (default) and the
12215
current function is larger than 256 bytes, <small>DDD</small> only disassembles
10700
<p>The ‘<samp><span class="samp">maxDisassemble</span></samp>’ resource controls how much is to be
10701
disassembled. If ‘<samp><span class="samp">maxDisassemble</span></samp>’ is set to 256 (default) and the
10702
current function is larger than 256 bytes, <acronym>DDD</acronym> only disassembles
12216
10703
the first 256 bytes below the current location. You can set the
12217
<code>maxDisassemble</code> resource to a larger value if you prefer to have a
10704
‘<samp><span class="samp">maxDisassemble</span></samp>’ resource to a larger value if you prefer to have a
12218
10705
larger machine code view.
12219
10706
12220
<p>
12221
<table width="100%">
12222
<tr>
12223
<td align="left"><b>maxDisassemble</b><i> </i>(<i>class MaxDisassemble</i>)<i>
12224
</i></td>
12225
<td align="right">Resource</td>
12226
</tr>
12227
</table>
12228
<table width="95%" align="center">
12229
<tr><td>
12230
Maximum number of bytes to disassemble (default: <code>256</code>). If this
10707
<div class="defun">
10708
— Resource: <b>maxDisassemble</b> (<var>class MaxDisassemble</var>)<var><a name="index-maxDisassemble-1166"></a></var><br>
10709
<blockquote><p>Maximum number of bytes to disassemble (default: <code>256</code>). If this
12231
10710
is zero, the entire current function is disassembled.
12232
</td></tr>
12233
</table>
10711
</p></blockquote></div>
12234
10712
12235
10713
<div class="node">
12236
10714
<p><hr>
12237
<small class=header>
12238
Node:<a name="Changing%20the%20Program">Changing the Program</a>,
12239
Next:<a rel="next" accesskey="n" href="#Commands">Commands</a>,
12240
Previous:<a rel="previous" accesskey="p" href="#Machine-Level%20Debugging">Machine-Level Debugging</a>,
12241
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
10715
<a name="Changing-the-Program"></a>
10716
Next: <a rel="next" accesskey="n" href="#Commands">Commands</a>,
10717
Previous: <a rel="previous" accesskey="p" href="#Machine_002dLevel-Debugging">Machine-Level Debugging</a>,
10718
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
12242
10719
</small>
12243
10720
12244
<br>
10721
12245
10722
</div>
12246
10723
12247
<h2 class="chapter">Changing the Program</h2>
10724
<h2 class="chapter">9 Changing the Program</h2>
12248
10725
12249
<p><small>DDD</small> offers some basic facilities to edit and recompile the
10726
<p><acronym>DDD</acronym> offers some basic facilities to edit and recompile the
12250
10727
source code, as well as patching executables and core files.
12251
10728
12252
10729
<ul class="menu">
12253
<li><a accesskey="1" href="#Editing%20Source%20Code">Editing Source Code</a>: You can invoke a source editor from <small>DDD</small>.
12254
<li><a accesskey="2" href="#Recompiling">Recompiling</a>: Invoking <code>make</code> from within <small>DDD</small>.
10730
<li><a accesskey="1" href="#Editing-Source-Code">Editing Source Code</a>: You can invoke a source editor from <acronym>DDD</acronym>.
10731
<li><a accesskey="2" href="#Recompiling">Recompiling</a>: Invoking <code>make</code> from within <acronym>DDD</acronym>.
12255
10732
<li><a accesskey="3" href="#Patching">Patching</a>: Changing source and object code.
12256
10733
</ul>
12257
10734
12258
10735
<div class="node">
12259
10736
<p><hr>
12260
<small class=header>
12261
Node:<a name="Editing%20Source%20Code">Editing Source Code</a>,
12262
Next:<a rel="next" accesskey="n" href="#Recompiling">Recompiling</a>,
12263
Up:<a rel="up" accesskey="u" href="#Changing%20the%20Program">Changing the Program</a>
10737
<a name="Editing-Source-Code"></a>
10738
Next: <a rel="next" accesskey="n" href="#Recompiling">Recompiling</a>,
10739
Up: <a rel="up" accesskey="u" href="#Changing-the-Program">Changing the Program</a>
12264
10740
</small>
12265
10741
12266
<br>
10742
12267
10743
</div>
12268
10744
12269
<h3 class="section">Editing Source Code</h3>
10745
<h3 class="section">9.1 Editing Source Code</h3>
12270
10746
12271
<p>In <small>DDD</small> itself, you cannot change the source file currently
12272
displayed. Instead, <small>DDD</small> allows you to invoke a <em>text
10747
<p><a name="index-Editing-source-code-1167"></a><a name="index-Source-code_002c-editing-1168"></a>
10748
<a name="index-Edit-1169"></a><a name="index-Edit-Source-1170"></a>In <acronym>DDD</acronym> itself, you cannot change the source file currently
10749
displayed. Instead, <acronym>DDD</acronym> allows you to invoke a <em>text
12273
10750
editor</em>. To invoke a text editor for the current source file, select
12274
the <code>Edit</code> button or <code>Source => Edit Source</code>.
10751
the ‘<samp><span class="samp">Edit</span></samp>’ button or ‘<samp><span class="samp">Source Edit Source</span></samp>’.
12275
10752
12276
<p>By default, <small>DDD</small> tries a number of common editors. You can
12277
customize <small>DDD</small> to use your favorite editor; See <a href="#Customizing%20Editing">Customizing Editing</a>, for details.
10753
<p><a name="index-Edit-Sources-1171"></a>By default, <acronym>DDD</acronym> tries a number of common editors. You can
10754
customize <acronym>DDD</acronym> to use your favorite editor; See <a href="#Customizing-Editing">Customizing Editing</a>, for details.
12278
10755
12279
10756
<p>After the editor has exited, the source code shown is automatically
12280
10757
updated.
12281
10758
12282
<p>If you have <small>DDD</small> and an editor running in parallel, you can also
12283
update the source code manually via <code>Source => Reload
12284
Source</code>. This reloads the source code shown from the source file.
12285
Since <small>DDD</small> automatically reloads the source code if the debugged
10759
<p><a name="index-Reloading-source-code-1172"></a><a name="index-Source-code_002c-reloading-1173"></a><a name="index-Reload-Source-1174"></a>If you have <acronym>DDD</acronym> and an editor running in parallel, you can also
10760
update the source code manually via ‘<samp><span class="samp">Source Reload
10761
Source</span></samp>’. This reloads the source code shown from the source file.
10762
Since <acronym>DDD</acronym> automatically reloads the source code if the debugged
12286
10763
program has been recompiled, this should seldom be necessary.
12287
10764
12288
10765
<ul class="menu">
12289
<li><a accesskey="1" href="#Customizing%20Editing">Customizing Editing</a>:
12290
<li><a accesskey="2" href="#In-Place%20Editing">In-Place Editing</a>:
10766
<li><a accesskey="1" href="#Customizing-Editing">Customizing Editing</a>
10767
<li><a accesskey="2" href="#In_002dPlace-Editing">In-Place Editing</a>
12291
10768
</ul>
12292
10769
12293
10770
<div class="node">
12294
10771
<p><hr>
12295
<small class=header>
12296
Node:<a name="Customizing%20Editing">Customizing Editing</a>,
12297
Next:<a rel="next" accesskey="n" href="#In-Place%20Editing">In-Place Editing</a>,
12298
Up:<a rel="up" accesskey="u" href="#Editing%20Source%20Code">Editing Source Code</a>
10772
<a name="Customizing-Editing"></a>
10773
Next: <a rel="next" accesskey="n" href="#In_002dPlace-Editing">In-Place Editing</a>,
10774
Up: <a rel="up" accesskey="u" href="#Editing-Source-Code">Editing Source Code</a>
12299
10775
</small>
12300
10776
12301
<br>
10777
12302
10778
</div>
12303
10779
12304
<h4 class="subsection">Customizing Editing</h4>
10780
<h4 class="subsection">9.1.1 Customizing Editing</h4>
12305
10781
12306
<p>You can customize the editor to be used via <code>Edit =>
12307
Preferences => Helpers => Edit Sources</code>. This is tied to
10782
<p>You can customize the editor to be used via ‘<samp><span class="samp">Edit
10783
Preferences Helpers Edit Sources</span></samp>’. This is tied to
12308
10784
the following resource:
12309
10785
12310
<p>
12311
<table width="100%">
12312
<tr>
12313
<td align="left"><b>editCommand</b><i> </i>(<i>class EditCommand</i>)<i>
12314
</i></td>
12315
<td align="right">Resource</td>
12316
</tr>
12317
</table>
12318
<table width="95%" align="center">
12319
<tr><td>
12320
A command string to invoke an editor on the specific file.
12321
<code>@LINE@</code> is replaced by the current line number, <code>@FILE@</code>
12322
by the file name. The default is to invoke <code>$XEDITOR</code> first, then
12323
<code>$EDITOR</code>, then <code>vi</code>:
10786
<div class="defun">
10787
— Resource: <b>editCommand</b> (<var>class EditCommand</var>)<var><a name="index-editCommand-1175"></a></var><br>
10788
<blockquote><p><a name="index-XEDITOR-1176"></a><a name="index-EDITOR-1177"></a><a name="index-vi-1178"></a>A command string to invoke an editor on the specific file.
10789
‘<samp><span class="samp">@LINE@</span></samp>’ is replaced by the current line number, ‘<samp><span class="samp">@FILE@</span></samp>’
10790
by the file name. The default is to invoke <samp><span class="command">$XEDITOR</span></samp> first, then
10791
<samp><span class="command">$EDITOR</span></samp>, then <samp><span class="command">vi</span></samp>:
12324
10792
12325
10793
<pre class="example"> Ddd*editCommand: \
12326
10794
${XEDITOR-false} +@LINE@ @FILE@ || \
12327
10795
xterm -e ${EDITOR-vi} +@LINE@ @FILE@
12328
</pre>
12329
</td></tr>
12330
</table>
10796
</pre>
10797
</blockquote></div>
12331
10798
12332
<p>This <code>~/.ddd/init</code> setting invokes an editing session
12333
for an XEmacs editor running <code>gnuserv</code>:
10799
<p><a name="index-gnuclient-1179"></a><a name="index-gnuserv-1180"></a><a name="index-xemacs-1181"></a>This <samp><span class="file">~/.ddd/init</span></samp> setting invokes an editing session
10800
for an XEmacs editor running <samp><span class="command">gnuserv</span></samp>:
12334
10801
12335
10802
<pre class="example"> Ddd*editCommand: gnuclient +@LINE@ @FILE@
12336
</pre>
12337
12338
<p>This <code>~/.ddd/init</code> setting invokes an editing session for an
12339
Emacs editor running <code>emacsserver</code>:
10803
</pre>
10804
<p><a name="index-emacsclient-1182"></a><a name="index-emacsserver-1183"></a><a name="index-emacs-1184"></a>This <samp><span class="file">~/.ddd/init</span></samp> setting invokes an editing session for an
10805
Emacs editor running <samp><span class="command">emacsserver</span></samp>:
12340
10806
12341
10807
<pre class="example"> Ddd*editCommand: emacsclient +@LINE@ @FILE@
12342
</pre>
12343
12344
<div class="node">
12345
<p><hr>
12346
<small class=header>
12347
Node:<a name="In-Place%20Editing">In-Place Editing</a>,
12348
Previous:<a rel="previous" accesskey="p" href="#Customizing%20Editing">Customizing Editing</a>,
12349
Up:<a rel="up" accesskey="u" href="#Editing%20Source%20Code">Editing Source Code</a>
12350
</small>
12351
12352
<br>
12353
</div>
12354
12355
<h4 class="subsection">In-Place Editing</h4>
12356
12357
<p>This resource is experimental:
12358
12359
<p>
12360
<table width="100%">
12361
<tr>
12362
<td align="left"><b>sourceEditing</b><i> </i>(<i>class SourceEditing</i>)<i>
12363
</i></td>
12364
<td align="right">Resource</td>
12365
</tr>
12366
</table>
12367
<table width="95%" align="center">
12368
<tr><td>
12369
If this is <code>on</code>, the displayed source code becomes editable.
12370
This is an experimental feature; Default is <code>off</code>.
12371
</td></tr>
12372
</table>
12373
12374
<div class="node">
12375
<p><hr>
12376
<small class=header>
12377
Node:<a name="Recompiling">Recompiling</a>,
12378
Next:<a rel="next" accesskey="n" href="#Patching">Patching</a>,
12379
Previous:<a rel="previous" accesskey="p" href="#Editing%20Source%20Code">Editing Source Code</a>,
12380
Up:<a rel="up" accesskey="u" href="#Changing%20the%20Program">Changing the Program</a>
12381
</small>
12382
12383
<br>
12384
</div>
12385
12386
<h3 class="section">Recompiling</h3>
12387
12388
<p>To recompile the source code using <code>make</code>, you can select
12389
<code>File => Make</code>. This pops up a dialog where you can enter a
12390
<em>Make Target</em>--typically the name of the executable. Clicking on
12391
the <code>Make</code> button invokes the <code>make</code> program with the given
10808
</pre>
10809
<div class="node">
10810
<p><hr>
10811
<a name="In-Place-Editing"></a>
10812
<a name="In_002dPlace-Editing"></a>
10813
Previous: <a rel="previous" accesskey="p" href="#Customizing-Editing">Customizing Editing</a>,
10814
Up: <a rel="up" accesskey="u" href="#Editing-Source-Code">Editing Source Code</a>
10815
</small>
10816
10817
10818
</div>
10819
10820
<h4 class="subsection">9.1.2 In-Place Editing</h4>
10821
10822
<p>This resource is experimental:
10823
10824
<div class="defun">
10825
— Resource: <b>sourceEditing</b> (<var>class SourceEditing</var>)<var><a name="index-sourceEditing-1185"></a></var><br>
10826
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’, the displayed source code becomes editable.
10827
This is an experimental feature; Default is ‘<samp><span class="samp">off</span></samp>’.
10828
</p></blockquote></div>
10829
10830
<div class="node">
10831
<p><hr>
10832
<a name="Recompiling"></a>
10833
Next: <a rel="next" accesskey="n" href="#Patching">Patching</a>,
10834
Previous: <a rel="previous" accesskey="p" href="#Editing-Source-Code">Editing Source Code</a>,
10835
Up: <a rel="up" accesskey="u" href="#Changing-the-Program">Changing the Program</a>
10836
</small>
10837
10838
10839
</div>
10840
10841
<h3 class="section">9.2 Recompiling</h3>
10842
10843
<p><a name="index-Recompiling-1186"></a><a name="index-Source-code_002c-recompiling-1187"></a><a name="index-make-1188"></a><a name="index-Make-1189"></a><a name="index-Make_002c-invoking-1190"></a>
10844
To recompile the source code using <samp><span class="command">make</span></samp>, you can select
10845
‘<samp><span class="samp">File Make</span></samp>’. This pops up a dialog where you can enter a
10846
<em>Make Target</em>—typically the name of the executable. Clicking on
10847
the ‘<samp><span class="samp">Make</span></samp>’ button invokes the <samp><span class="command">make</span></samp> program with the given
12392
10848
target.
12393
10849
12394
<p>The <code>Make</code> button on the command tool re-invokes <code>make</code>
10850
<p>The ‘<samp><span class="samp">Make</span></samp>’ button on the command tool re-invokes <samp><span class="command">make</span></samp>
12395
10851
with the most recently given arguments.
12396
10852
12397
10853
<div class="node">
12398
10854
<p><hr>
12399
<small class=header>
12400
Node:<a name="Patching">Patching</a>,
12401
Previous:<a rel="previous" accesskey="p" href="#Recompiling">Recompiling</a>,
12402
Up:<a rel="up" accesskey="u" href="#Changing%20the%20Program">Changing the Program</a>
10855
<a name="Patching"></a>
10856
Previous: <a rel="previous" accesskey="p" href="#Recompiling">Recompiling</a>,
10857
Up: <a rel="up" accesskey="u" href="#Changing-the-Program">Changing the Program</a>
12403
10858
</small>
12404
10859
12405
<br>
10860
12406
10861
</div>
12407
10862
12408
<h3 class="section">Patching</h3>
10863
<h3 class="section">9.3 Patching</h3>
12409
10864
12410
<p>Using <small>GDB</small>, you can open your program's executable code (and the core
10865
<p><a name="index-Patching-1191"></a><a name="index-Program_002c-patching-1192"></a><a name="index-Emergency-repairs-1193"></a><a name="index-Debugging-flags-1194"></a>Using <acronym>GDB</acronym>, you can open your program's executable code (and the core
12411
10866
file) for both reading and writing. This allows alterations to machine
12412
10867
code, such that you can intentionally patch your program's binary. For
12413
10868
example, you might want to turn on internal debugging flags, or even to
12417
10872
such as setting permissions, may be needed before you can change
12418
10873
executable files.
12419
10874
12420
<p>To patch the binary, enable <code>Edit => </code><small>GDB</small><code> Settings =>
12421
Writing into executable and core files</code>. This makes <small>GDB</small> open executable
10875
<p><a name="index-Writing-into-executable-and-core-files-1195"></a>To patch the binary, enable ‘<samp><span class="samp">Edit <acronym>GDB</acronym> Settings
10876
Writing into executable and core files</span></samp>’. This makes <acronym>GDB</acronym> open executable
12422
10877
and core files for both reading and writing. If you have already loaded
12423
a file, you must load it again (using <code>Edit => Open File</code> or
12424
<code>Edit => Open Core</code>), for your new setting to take effect.
10878
a file, you must load it again (using ‘<samp><span class="samp">Edit Open File</span></samp>’ or
10879
‘<samp><span class="samp">Edit Open Core</span></samp>’), for your new setting to take effect.
12425
10880
12426
<p>Be sure to turn off <code>Writing into executable and core files</code> as
10881
<p>Be sure to turn off ‘<samp><span class="samp">Writing into executable and core files</span></samp>’ as
12427
10882
soon as possible, to prevent accidental alterations to machine code.
12428
10883
12429
10884
<div class="node">
12430
10885
<p><hr>
12431
<small class=header>
12432
Node:<a name="Commands">Commands</a>,
12433
Next:<a rel="next" accesskey="n" href="#Application%20Defaults">Application Defaults</a>,
12434
Previous:<a rel="previous" accesskey="p" href="#Changing%20the%20Program">Changing the Program</a>,
12435
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
10886
<a name="Commands"></a>
10887
Next: <a rel="next" accesskey="n" href="#Application-Defaults">Application Defaults</a>,
10888
Previous: <a rel="previous" accesskey="p" href="#Changing-the-Program">Changing the Program</a>,
10889
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
12436
10890
</small>
12437
10891
12438
<br>
10892
12439
10893
</div>
12440
10894
12441
<h2 class="chapter">The Command-Line Interface</h2>
10895
<h2 class="chapter">10 The Command-Line Interface</h2>
12442
10896
12443
<p>All the buttons you click within <small>DDD</small> get eventually translated
10897
<p>All the buttons you click within <acronym>DDD</acronym> get eventually translated
12444
10898
into some debugger command, shown in the debugger console. You can also
12445
10899
type in and edit these commands directly.
12446
10900
12447
10901
<ul class="menu">
12448
<li><a accesskey="1" href="#Entering%20Commands">Entering Commands</a>: Direct interaction with the inferior debugger.
12449
<li><a accesskey="2" href="#TTY%20mode">TTY mode</a>: Controlling <small>DDD</small> from a terminal.
12450
<li><a accesskey="3" href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>: <small>DDD</small> and your programming environment.
12451
<li><a accesskey="4" href="#Defining%20Buttons">Defining Buttons</a>: Add your own <small>DDD</small> buttons.
12452
<li><a accesskey="5" href="#Defining%20Commands">Defining Commands</a>: Add your own <small>DDD</small> commands.
10902
<li><a accesskey="1" href="#Entering-Commands">Entering Commands</a>: Direct interaction with the inferior debugger.
10903
<li><a accesskey="2" href="#TTY-mode">TTY mode</a>: Controlling <acronym>DDD</acronym> from a terminal.
10904
<li><a accesskey="3" href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">Integrating <acronym>DDD</acronym></a>: <acronym>DDD</acronym> and your programming environment.
10905
<li><a accesskey="4" href="#Defining-Buttons">Defining Buttons</a>: Add your own <acronym>DDD</acronym> buttons.
10906
<li><a accesskey="5" href="#Defining-Commands">Defining Commands</a>: Add your own <acronym>DDD</acronym> commands.
12453
10907
</ul>
12454
10908
12455
10909
<div class="node">
12456
10910
<p><hr>
12457
<small class=header>
12458
Node:<a name="Entering%20Commands">Entering Commands</a>,
12459
Next:<a rel="next" accesskey="n" href="#TTY%20mode">TTY mode</a>,
12460
Up:<a rel="up" accesskey="u" href="#Commands">Commands</a>
10911
<a name="Entering-Commands"></a>
10912
Next: <a rel="next" accesskey="n" href="#TTY-mode">TTY mode</a>,
10913
Up: <a rel="up" accesskey="u" href="#Commands">Commands</a>
12461
10914
</small>
12462
10915
12463
<br>
10916
12464
10917
</div>
12465
10918
12466
<h3 class="section">Entering Commands</h3>
10919
<h3 class="section">10.1 Entering Commands</h3>
12467
10920
12468
<p>In the <em>debugger console</em>, you can interact with the command
10921
<p>In the <em>debugger console</em>, you can interact with the command
12469
10922
interface of the inferior debugger. Enter commands at the
12470
<em>debugger prompt</em>--that is, <code>(gdb)</code> for <small>GDB</small>,
12471
<code>(dbx)</code> for <small>DBX</small>, <code>(ladebug)</code> for Ladebug, <code>></code> for
12472
<small>XDB</small>, <code>></code> and <code></code><var>thread</var><code>[</code><var>depth</var><code>]</code> for <small>JDB</small>, or
12473
<code>(Pydb)</code> for <small>PYDB</small>, or <code>DB<></code> for Perl, or
12474
<code>bashdb<></code> for Bash. You can use arbitrary debugger commands; use the
10923
<em>debugger prompt</em>—that is,
10924
‘<samp><span class="samp">(gdb)</span></samp>’ for <acronym>GDB</acronym>,
10925
‘<samp><span class="samp">bashdb<></span></samp>’ for Bash,
10926
‘<samp><span class="samp">(dbx)</span></samp>’ for <acronym>DBX</acronym>,
10927
‘<samp><span class="samp">></span></samp>’ ‘<samp><var>thread</var><span class="samp">[</span><var>depth</var><span class="samp">]</span></samp>’ for <acronym>JDB</acronym>,
10928
‘<samp><span class="samp">(ladebug)</span></samp>’ for Ladebug,
10929
‘<samp><span class="samp">mdb<></span></samp>’ for the GNU Make debugger,
10930
‘<samp><span class="samp">DB<></span></samp>’ for Perl,
10931
‘<samp><span class="samp">(Pydb)</span></samp>’ for <code>pydb</code>,
10932
or ‘<samp><span class="samp">></span></samp>’ for <acronym>XDB</acronym>.
10933
You can use arbitrary debugger commands; use the
12475
10934
<Return> key to enter them.
12476
10935
12477
10936
<ul class="menu">
12478
<li><a accesskey="1" href="#Command%20Completion">Command Completion</a>: Using the <TAB> key.
12479
<li><a accesskey="2" href="#Command%20History">Command History</a>: Repeating previous commands.
12480
<li><a accesskey="3" href="#Typing%20in%20the%20Source%20Window">Typing in the Source Window</a>:
10937
<li><a accesskey="1" href="#Command-Completion">Command Completion</a>: Using the <TAB> key.
10938
<li><a accesskey="2" href="#Command-History">Command History</a>: Repeating previous commands.
10939
<li><a accesskey="3" href="#Typing-in-the-Source-Window">Typing in the Source Window</a>
12481
10940
</ul>
12482
10941
12483
10942
<div class="node">
12484
10943
<p><hr>
12485
<small class=header>
12486
Node:<a name="Command%20Completion">Command Completion</a>,
12487
Next:<a rel="next" accesskey="n" href="#Command%20History">Command History</a>,
12488
Up:<a rel="up" accesskey="u" href="#Entering%20Commands">Entering Commands</a>
10944
<a name="Command-Completion"></a>
10945
Next: <a rel="next" accesskey="n" href="#Command-History">Command History</a>,
10946
Up: <a rel="up" accesskey="u" href="#Entering-Commands">Entering Commands</a>
12489
10947
</small>
12490
10948
12491
<br>
10949
12492
10950
</div>
12493
10951
12494
<h4 class="subsection">Command Completion</h4>
10952
<h4 class="subsection">10.1.1 Command Completion</h4>
12495
10953
12496
<p>When using <small>GDB</small> or Perl, you can use the <TAB> key for
10954
<p><a name="index-Completion-of-commands-1196"></a><a name="index-Command-completion-1197"></a>
10955
When using <acronym>GDB</acronym> or Perl, you can use the <TAB> key for
12497
10956
<em>completing</em> commands and arguments. This works in the debugger
12498
10957
console as well as in all other text windows.
12499
10958
12500
<p><small>GDB</small> can fill in the rest of a word in a command for you, if there is
10959
<p><acronym>GDB</acronym> can fill in the rest of a word in a command for you, if there is
12501
10960
only one possibility; it can also show you what the valid possibilities
12502
are for the next word in a command, at any time. This works for <small>GDB</small>
12503
commands, <small>GDB</small> subcommands, and the names of symbols in your program.
10961
are for the next word in a command, at any time. This works for <acronym>GDB</acronym>
10962
commands, <acronym>GDB</acronym> subcommands, and the names of symbols in your program.
12504
10963
12505
<p>Press the <TAB> key whenever you want <small>GDB</small> to fill out the rest
12506
of a word. If there is only one possibility, <small>GDB</small> fills in the
10964
<p>Press the <TAB> key whenever you want <acronym>GDB</acronym> to fill out the rest
10965
of a word. If there is only one possibility, <acronym>GDB</acronym> fills in the
12507
10966
word, and waits for you to finish the command (or press <RET> to
12508
10967
enter it). For example, if you type
12509
10968
<pre class="example"> (gdb) <kbd>info bre_<TAB></kbd>
12510
</pre>
12511
12512
<p><small>GDB</small> fills in the rest of the word <code>breakpoints</code>, since that is
12513
the only <code>info</code> subcommand beginning with <code>bre</code>:
10969
</pre>
10970
<p class="noindent"><acronym>GDB</acronym> fills in the rest of the word ‘<samp><span class="samp">breakpoints</span></samp>’, since that is
10971
the only <samp><span class="command">info</span></samp> subcommand beginning with ‘<samp><span class="samp">bre</span></samp>’:
12514
10972
12515
10973
<pre class="example"> (gdb) <kbd>info breakpoints</kbd>
12516
</pre>
12517
12518
<p>You can either press <RET> at this point, to run the <code>info
12519
breakpoints</code> command, or backspace and enter something else, if
12520
<code>breakpoints</code> does not look like the command you expected. (If you
12521
were sure you wanted <code>info breakpoints</code> in the first place, you
12522
might as well just type <RET> immediately after <code>info bre</code>, to
10974
</pre>
10975
<p class="noindent">You can either press <RET> at this point, to run the <samp><span class="command">info
10976
breakpoints</span></samp> command, or backspace and enter something else, if
10977
‘<samp><span class="samp">breakpoints</span></samp>’ does not look like the command you expected. (If you
10978
were sure you wanted <samp><span class="command">info breakpoints</span></samp> in the first place, you
10979
might as well just type <RET> immediately after ‘<samp><span class="samp">info bre</span></samp>’, to
12523
10980
exploit command abbreviations rather than command completion).
12524
10981
12525
10982
<p>If there is more than one possibility for the next word when you press
12526
<TAB>, <small>DDD</small> sounds a bell. You can either supply more
12527
characters and try again, or just press <TAB> a second time; <small>GDB</small>
10983
<TAB>, <acronym>DDD</acronym> sounds a bell. You can either supply more
10984
characters and try again, or just press <TAB> a second time; <acronym>GDB</acronym>
12528
10985
displays all the possible completions for that word. For example, you
12529
10986
might want to set a breakpoint on a subroutine whose name begins with
12530
<code>make_</code>, but when you type <kbd>b make_<TAB></kbd>, <small>DDD</small> just
10987
‘<samp><span class="samp">make_</span></samp>’, but when you type <kbd>b make_<TAB></kbd>, <acronym>DDD</acronym> just
12531
10988
sounds the bell. Typing <TAB> again displays all the function names
12532
10989
in your program that begin with those characters. If you type <TAB>
12533
10990
again, you cycle through the list of completions, for example:
12534
10991
12535
10992
<pre class="example"> (gdb) <kbd>b make</kbd>_ <TAB>
12536
<br><small>DDD</small> sounds bell; press <TAB> again, to see:<br>
10993
<br><acronym>DDD</acronym> sounds bell; press <TAB> again, to see:<br>
12537
10994
make_a_section_from_file make_environ
12538
10995
make_abs_section make_function_type
12539
10996
make_blockvector make_pointer_type
12540
10997
make_cleanup make_reference_type
12541
10998
make_command make_symbol_completion_list
12542
10999
(gdb) <kbd>b make</kbd>_ <TAB>
12543
<br><small>DDD</small> presents one expansion after the other:<br>
11000
<br><acronym>DDD</acronym> presents one expansion after the other:<br>
12544
11001
(gdb) b make_a_section_from_file <TAB>
12545
11002
(gdb) b make_abs_section <TAB>
12546
11003
(gdb) b make_blockvector <TAB>
12547
</pre>
12548
12549
<p>After displaying the available possibilities, <small>GDB</small> copies your partial
12550
input (<code>b make_</code> in the example) so you can finish the command--by
11004
</pre>
11005
<p class="noindent">After displaying the available possibilities, <acronym>GDB</acronym> copies your partial
11006
input (‘<samp><span class="samp">b make_</span></samp>’ in the example) so you can finish the command—by
12551
11007
pressing <TAB> again, or by entering the remainder manually.
12552
11008
12553
<p>Sometimes the string you need, while logically a "word", may contain
12554
parentheses or other characters that <small>GDB</small> normally excludes from its
11009
<p><a name="index-Quotes-in-commands-1198"></a><a name="index-Completion-of-quoted-strings-1199"></a>Sometimes the string you need, while logically a “word”, may contain
11010
parentheses or other characters that <acronym>GDB</acronym> normally excludes from its
12555
11011
notion of a word. To permit word completion to work in this situation,
12556
you may enclose words in <code>'</code> (single quote marks) in <small>GDB</small> commands.
11012
you may enclose words in <code>'</code> (single quote marks) in <acronym>GDB</acronym> commands.
12557
11013
12558
11014
<p>The most likely situation where you might need this is in typing the
12559
11015
name of a C++ function. This is because C++ allows function overloading
12563
11019
<code>int</code> parameter, <code>name(int)</code>, or the version that takes a
12564
11020
<code>float</code> parameter, <code>name(float)</code>. To use the word-completion
12565
11021
facilities in this situation, type a single quote <code>'</code> at the
12566
beginning of the function name. This alerts <small>GDB</small> that it may need to
11022
beginning of the function name. This alerts <acronym>GDB</acronym> that it may need to
12567
11023
consider more information than usual when you press <TAB> to request
12568
11024
word completion:
12569
11025
12570
11026
<pre class="example"> (gdb) <kbd>b 'bubble(</kbd>_<TAB>
12571
11027
bubble(double,double) bubble(int,int)
12572
11028
(gdb) <kbd>b 'bubble(</kbd>_
12573
</pre>
12574
12575
<p>In some cases, <small>DDD</small> can tell that completing a name requires
12576
using quotes. When this happens, <small>DDD</small> inserts the quote for you
11029
</pre>
11030
<p>In some cases, <acronym>DDD</acronym> can tell that completing a name requires
11031
using quotes. When this happens, <acronym>DDD</acronym> inserts the quote for you
12577
11032
(while completing as much as it can) if you do not type the quote in the
12578
11033
first place:
12579
11034
12580
11035
<pre class="example"> (gdb) <kbd>b bub</kbd>_<TAB>
12581
<br><small>DDD</small> alters your input line to the following, and rings a bell:<br>
11036
<br><acronym>DDD</acronym> alters your input line to the following, and rings a bell:<br>
12582
11037
(gdb) <kbd>b 'bubble(</kbd>_
12583
</pre>
12584
12585
<p>In general, <small>DDD</small> can tell that a quote is needed (and inserts it)
11038
</pre>
11039
<p class="noindent">In general, <acronym>DDD</acronym> can tell that a quote is needed (and inserts it)
12586
11040
if you have not yet started typing the argument list when you ask for
12587
11041
completion on an overloaded symbol.
12588
11042
12589
11043
<p>If you prefer to use the <TAB> key for switching between items,
12590
unset <code>Edit => Preferences => General => TAB
12591
Key completes in All Windows</code>. This is useful if you have
11044
unset ‘<samp><span class="samp">Edit Preferences General TAB
11045
Key completes in All Windows</span></samp>’. This is useful if you have
12592
11046
pointer-driven keyboard focus (see below) and no special usage for the
12593
11047
<TAB> key. If the option is set, the <TAB> key completes in the
12594
11048
debugger console only.
12595
11049
12596
11050
<p>This option is tied to the following resource:
12597
11051
12598
<p>
12599
<table width="100%">
12600
<tr>
12601
<td align="left"><b>globalTabCompletion</b><i> </i>(<i>class GlobalTabCompletion</i>)<i>
12602
</i></td>
12603
<td align="right">Resource</td>
12604
</tr>
12605
</table>
12606
<table width="95%" align="center">
12607
<tr><td>
12608
If this is <code>on</code> (default), the <TAB> key completes arguments in
12609
all windows. If this is <code>off</code>, the <TAB> key completes
11052
<div class="defun">
11053
— Resource: <b>globalTabCompletion</b> (<var>class GlobalTabCompletion</var>)<var><a name="index-globalTabCompletion-1200"></a></var><br>
11054
<blockquote><p>If this is ‘<samp><span class="samp">on</span></samp>’ (default), the <TAB> key completes arguments in
11055
all windows. If this is ‘<samp><span class="samp">off</span></samp>’, the <TAB> key completes
12610
11056
arguments in the debugger console only.
12611
</td></tr>
12612
</table>
11057
</p></blockquote></div>
12613
11058
12614
11059
<div class="node">
12615
11060
<p><hr>
12616
<small class=header>
12617
Node:<a name="Command%20History">Command History</a>,
12618
Next:<a rel="next" accesskey="n" href="#Typing%20in%20the%20Source%20Window">Typing in the Source Window</a>,
12619
Previous:<a rel="previous" accesskey="p" href="#Command%20Completion">Command Completion</a>,
12620
Up:<a rel="up" accesskey="u" href="#Entering%20Commands">Entering Commands</a>
11061
<a name="Command-History"></a>
11062
Next: <a rel="next" accesskey="n" href="#Typing-in-the-Source-Window">Typing in the Source Window</a>,
11063
Previous: <a rel="previous" accesskey="p" href="#Command-Completion">Command Completion</a>,
11064
Up: <a rel="up" accesskey="u" href="#Entering-Commands">Entering Commands</a>
12621
11065
</small>
12622
11066
12623
<br>
11067
12624
11068
</div>
12625
11069
12626
<h4 class="subsection">Command History</h4>
11070
<h4 class="subsection">10.1.2 Command History</h4>
12627
11071
12628
<p>You can <em>repeat</em> previous and next commands by pressing the
11072
<p><a name="index-Command_002c-repeating-1201"></a><a name="index-Command_002c-searching-1202"></a><a name="index-Command-history-1203"></a><a name="index-Searching-commands-1204"></a><a name="index-Up-1205"></a><a name="index-Down-1206"></a><a name="index-Return-1207"></a>You can <em>repeat</em> previous and next commands by pressing the
12629
11073
<Up> and <Down> arrow keys, respectively. This presents you
12630
11074
previous and later commands on the command line; use <Return> to
12631
11075
apply the current command.
12633
11077
<p>If you enter an empty line (just use <Return> at the debugger
12634
11078
prompt), the last command is repeated as well.
12635
11079
12636
<p><code>Commands => Command History</code> shows the command history.
12637
12638
<br><p>
11080
<p>‘<samp><span class="samp">Commands Command History</span></samp>’ shows the command history.
11081
11082
<pre class="sp">
11083
11084
</pre>
12639
11085
<div align="center"><img src="PICS/ddd-history.jpg" alt="PICS/ddd-history.jpg"></div>
12640
<br><p>
12641
<p>You can <em>search</em> for previous commands by pressing <Ctrl+B>.
11086
<pre class="sp">
11087
11088
</pre>
11089
11090
<a name="index-Ctrl_002bB-1208"></a><a name="index-Ctrl_002bF-1209"></a><a name="index-ESC-1210"></a>You can <em>search</em> for previous commands by pressing <Ctrl+B>.
12642
11091
This invokes <em>incremental search mode,</em> where you can enter a
12643
11092
string to be searched in previous commands. Press <Ctrl+B> again to
12644
11093
repeat the search, or <Ctrl+F> to search in the reverse direction.
12645
11094
To return to normal mode, press <ESC>, or use any cursor command.
12646
11095
12647
<p>The command history is automatically saved when exiting <small>DDD</small>.
11096
<p>The command history is automatically saved when exiting <acronym>DDD</acronym>.
12648
11097
You can turn off this feature by setting the following resource to
12649
<code>off</code>:
12650
12651
<p>
12652
<table width="100%">
12653
<tr>
12654
<td align="left"><b>saveHistoryOnExit</b><i> </i>(<i>class SaveOnExit</i>)<i>
12655
</i></td>
12656
<td align="right">Resource</td>
12657
</tr>
12658
</table>
12659
<table width="95%" align="center">
12660
<tr><td>
12661
If <code>on</code> (default), the command history is automatically saved
12662
when <small>DDD</small> exits.
12663
</td></tr>
12664
</table>
12665
11098
‘<samp><span class="samp">off</span></samp>’:
11099
11100
<div class="defun">
11101
— Resource: <b>saveHistoryOnExit</b> (<var>class SaveOnExit</var>)<var><a name="index-saveHistoryOnExit-1211"></a></var><br>
11102
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), the command history is automatically saved
11103
when <acronym>DDD</acronym> exits.
11104
</p></blockquote></div>
11105
11106
<!-- FIXME: more on history -->
12666
11107
<div class="node">
12667
11108
<p><hr>
12668
<small class=header>
12669
Node:<a name="Typing%20in%20the%20Source%20Window">Typing in the Source Window</a>,
12670
Previous:<a rel="previous" accesskey="p" href="#Command%20History">Command History</a>,
12671
Up:<a rel="up" accesskey="u" href="#Entering%20Commands">Entering Commands</a>
11109
<a name="Typing-in-the-Source-Window"></a>
11110
Previous: <a rel="previous" accesskey="p" href="#Command-History">Command History</a>,
11111
Up: <a rel="up" accesskey="u" href="#Entering-Commands">Entering Commands</a>
12672
11112
</small>
12673
11113
12674
<br>
11114
12675
11115
</div>
12676
11116
12677
<h4 class="subsection">Typing in the Source Window</h4>
11117
<h4 class="subsection">10.1.3 Typing in the Source Window</h4>
12678
11118
12679
<p>As a special convenience, anything you type into the source window is
11119
<p><a name="index-Source-file_002c-typing-into-1212"></a>As a special convenience, anything you type into the source window is
12680
11120
automatically forwarded to the debugger console. Thus, you don't have
12681
11121
to change the keyboard focus explicitly in order to enter commands.
12682
11122
12683
11123
<p>You can change this behaviour using the following resource:
12684
11124
12685
<p>
12686
<table width="100%">
12687
<tr>
12688
<td align="left"><b>consoleHasFocus</b><i> </i>(<i>class ConsoleHasFocus</i>)<i>
12689
</i></td>
12690
<td align="right">Resource</td>
12691
</tr>
12692
</table>
12693
<table width="95%" align="center">
12694
<tr><td>
12695
If <code>on</code> (default), all keyboard events in the source window are
12696
automatically forwarded to the debugger console. If <code>off</code>,
12697
keyboard events are not forwarded. If <code>auto</code>, keyboard events
11125
<div class="defun">
11126
— Resource: <b>consoleHasFocus</b> (<var>class ConsoleHasFocus</var>)<var><a name="index-consoleHasFocus-1213"></a></var><br>
11127
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), all keyboard events in the source window are
11128
automatically forwarded to the debugger console. If ‘<samp><span class="samp">off</span></samp>’,
11129
keyboard events are not forwarded. If ‘<samp><span class="samp">auto</span></samp>’, keyboard events
12698
11130
forwarded only if the debugger console is open.
12699
</td></tr>
12700
</table>
11131
</p></blockquote></div>
12701
11132
12702
11133
<div class="node">
12703
11134
<p><hr>
12704
<small class=header>
12705
Node:<a name="TTY%20mode">TTY mode</a>,
12706
Next:<a rel="next" accesskey="n" href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>,
12707
Previous:<a rel="previous" accesskey="p" href="#Entering%20Commands">Entering Commands</a>,
12708
Up:<a rel="up" accesskey="u" href="#Commands">Commands</a>
11135
<a name="TTY-mode"></a>
11136
Next: <a rel="next" accesskey="n" href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">Integrating <acronym>DDD</acronym></a>,
11137
Previous: <a rel="previous" accesskey="p" href="#Entering-Commands">Entering Commands</a>,
11138
Up: <a rel="up" accesskey="u" href="#Commands">Commands</a>
12709
11139
</small>
12710
11140
12711
<br>
11141
12712
11142
</div>
12713
11143
12714
<h3 class="section">Entering Commands at the TTY</h3>
12715
12716
<p>Rather than entering commands at the debugger console, you may prefer to
12717
enter commands at the terminal window <small>DDD</small> was invoked from.
12718
12719
<p>When <small>DDD</small> is invoked using the <code>--tty</code> option, it enables its
12720
<em></em><small>TTY</small><em> interface</em>, taking additional debugger commands from
11144
<h3 class="section">10.2 Entering Commands at the TTY</h3>
11145
11146
<p><a name="index-g_t_0040acronym_007bTTY_007d-interface-1214"></a>
11147
Rather than entering commands at the debugger console, you may prefer to
11148
enter commands at the terminal window <acronym>DDD</acronym> was invoked from.
11149
11150
<p>When <acronym>DDD</acronym> is invoked using the <samp><span class="option">--tty</span></samp> option, it enables its
11151
<em><acronym>TTY</acronym> interface</em>, taking additional debugger commands from
12721
11152
standard input and forwarding debugger output to standard output, just
12722
11153
as if the inferior debugger had been invoked directly. All remaining
12723
<small>DDD</small> functionality stays unchanged.
12724
12725
<p>By default, the debugger console remains closed if <small>DDD</small> is
12726
invoked using the <code>--tty</code> option. Use <code>View =>
12727
Debugger Console</code> to open it.
12728
12729
<p><small>DDD</small> can be configured to use the <code>readline</code> library for reading
12730
in commands from standard input. This <small>GNU</small> library provides
11154
<acronym>DDD</acronym> functionality stays unchanged.
11155
11156
<p>By default, the debugger console remains closed if <acronym>DDD</acronym> is
11157
invoked using the <samp><span class="option">--tty</span></samp> option. Use ‘<samp><span class="samp">View
11158
Debugger Console</span></samp>’ to open it.
11159
11160
<p><a name="index-Readline-1215"></a><acronym>DDD</acronym> can be configured to use the ‘<samp><span class="samp">readline</span></samp>’ library for reading
11161
in commands from standard input. This <acronym>GNU</acronym> library provides
12731
11162
consistent behavior for programs which provide a command line interface
12732
to the user. Advantages are <small>GNU</small> Emacs-style or <dfn>vi</dfn>-style inline
12733
editing of commands, <code>csh</code>-like history substitution, and a
11163
to the user. Advantages are <acronym>GNU</acronym> Emacs-style or <dfn>vi</dfn>-style inline
11164
editing of commands, <samp><span class="command">csh</span></samp>-like history substitution, and a
12734
11165
storage and recall of command history across debugging sessions.
12735
See <a href="gdb.html#Command%20Line%20Editing">Command Line Editing</a>, for details on command-line editing via the
12736
<small>TTY</small> interface.
11166
See <a href="gdb.html#Command-Line-Editing">Command Line Editing</a>, for details on command-line editing via the
11167
<acronym>TTY</acronym> interface.
12737
11168
12738
11169
<div class="node">
12739
11170
<p><hr>
12740
<small class=header>
12741
Node:<a name="Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>,
12742
Next:<a rel="next" accesskey="n" href="#Defining%20Buttons">Defining Buttons</a>,
12743
Previous:<a rel="previous" accesskey="p" href="#TTY%20mode">TTY mode</a>,
12744
Up:<a rel="up" accesskey="u" href="#Commands">Commands</a>
11171
<a name="Integrating-%3cacronym%3eDDD%3c%2facronym%3e"></a>
11172
<a name="Integrating-_003cacronym_003eDDD_003c_002facronym_003e"></a>
11173
Next: <a rel="next" accesskey="n" href="#Defining-Buttons">Defining Buttons</a>,
11174
Previous: <a rel="previous" accesskey="p" href="#TTY-mode">TTY mode</a>,
11175
Up: <a rel="up" accesskey="u" href="#Commands">Commands</a>
12745
11176
</small>
12746
11177
12747
<br>
11178
12748
11179
</div>
12749
11180
12750
<h3 class="section">Integrating DDD</h3>
12751
12752
<p>You can run <small>DDD</small> as an inferior debugger in other debugger
12753
front-ends, combining their special abilities with those of <small>DDD</small>.
12754
12755
<p>To have <small>DDD</small> run as an inferior debugger in other front-ends, the
11181
<h3 class="section">10.3 Integrating DDD</h3>
11182
11183
<p><a name="index-Integrating-_0040DDD_007b_007d-1216"></a>
11184
You can run <acronym>DDD</acronym> as an inferior debugger in other debugger
11185
front-ends, combining their special abilities with those of <acronym>DDD</acronym>.
11186
11187
<p>To have <acronym>DDD</acronym> run as an inferior debugger in other front-ends, the
12756
11188
general idea is to set up your debugger front-end such that
12757
<code>ddd --tty</code> is invoked instead of the inferior debugger.
12758
When <small>DDD</small> is invoked using the <code>--tty</code> option, it enables its
12759
<em></em><small>TTY</small><em> interface</em>, taking additional debugger commands from
11189
‘<samp><span class="samp">ddd --tty</span></samp>’ is invoked instead of the inferior debugger.
11190
When <acronym>DDD</acronym> is invoked using the <samp><span class="option">--tty</span></samp> option, it enables its
11191
<em><acronym>TTY</acronym> interface</em>, taking additional debugger commands from
12760
11192
standard input and forwarding debugger output to standard output, just
12761
11193
as if the inferior debugger had been invoked directly. All remaining
12762
<small>DDD</small> functionality stays unchanged.
11194
<acronym>DDD</acronym> functionality stays unchanged.
12763
11195
12764
<p>In case your debugger front-end uses the <small>GDB</small> <code>-fullname</code>
12765
option to have <small>GDB</small> report source code positions, the <code>--tty</code>
12766
option is not required. <small>DDD</small> recognizes the <code>-fullname</code>
11196
<p>In case your debugger front-end uses the <acronym>GDB</acronym> <samp><span class="option">-fullname</span></samp>
11197
option to have <acronym>GDB</acronym> report source code positions, the <samp><span class="option">--tty</span></samp>
11198
option is not required. <acronym>DDD</acronym> recognizes the <samp><span class="option">-fullname</span></samp>
12767
11199
option, finds that it has been invoked from a debugger front-end and
12768
automatically enables the <small>TTY</small> interface.
11200
automatically enables the <acronym>TTY</acronym> interface.
12769
11201
12770
<p>If <small>DDD</small> is invoked with the <code>-fullname</code> option, the debugger
11202
<p>If <acronym>DDD</acronym> is invoked with the <samp><span class="option">-fullname</span></samp> option, the debugger
12771
11203
console and the source window are initially disabled, as their
12772
11204
facilities are supposed to be provided by the integrating front-end. In
12773
case of need, you can use the <code>View</code> menu to re-enable these
11205
case of need, you can use the ‘<samp><span class="samp">View</span></samp>’ menu to re-enable these
12774
11206
windows.
12775
11207
12776
<h4 class="subsection">Using DDD with Emacs</h4>
11208
<h4 class="subsection">10.3.1 Using DDD with Emacs</h4>
12777
11209
12778
<p>To integrate <small>DDD</small> with Emacs, use <kbd>M-x gdb</kbd> or <kbd>M-x dbx</kbd>
11210
<p><a name="index-Emacs_002c-integrating-_0040DDD_007b_007d-1217"></a><a name="index-emacs-1218"></a>To integrate <acronym>DDD</acronym> with Emacs, use <kbd>M-x gdb</kbd> or <kbd>M-x dbx</kbd>
12779
11211
in Emacs to start a debugging session. At the prompt, enter
12780
<code>ddd --tty</code> (followed by <code>--dbx</code> or
12781
<code>--gdb</code>, if required), and the name of the program to be
11212
<samp><span class="command">ddd --tty</span></samp> (followed by <samp><span class="option">--dbx</span></samp> or
11213
<samp><span class="option">--gdb</span></samp>, if required), and the name of the program to be
12782
11214
debugged. Proceed as usual.
12783
11215
12784
<h4 class="subsection">Using DDD with XEmacs</h4>
11216
<h4 class="subsection">10.3.2 Using DDD with XEmacs</h4>
12785
11217
12786
<p>To integrate <small>DDD</small> with XEmacs, set the variable
12787
<code>gdb-command-name</code> to <code>"ddd"</code>, by inserting the following line
12788
in your <code>~/.emacs</code> file:
11218
<p><a name="index-XEmacs_002c-integrating-_0040DDD_007b_007d-1219"></a><a name="index-xemacs-1220"></a><a name="index-g_t_002eemacs-1221"></a>To integrate <acronym>DDD</acronym> with XEmacs, set the variable
11219
<code>gdb-command-name</code> to ‘<samp><span class="samp">"ddd"</span></samp>’, by inserting the following line
11220
in your <samp><span class="file">~/.emacs</span></samp> file:
12789
11221
12790
11222
<pre class="example"> (setq gdb-command-name "ddd")
12791
</pre>
12792
11223
</pre>
12793
11224
<p>You can also evaluate this expression by pressing <ESC> <:> and
12794
11225
entering it directly (<ESC> <ESC> for XEmacs 19.13 and earlier).
12795
11226
12796
<p>To start a <small>DDD</small> debugging session in XEmacs, use <code>M-x gdb</code> or
12797
<code>M-x gdbsrc</code>. Proceed as usual.
12798
12799
<h4 class="subsection">Using DDD with <small>XXGDB</small></h4>
12800
12801
<p>To integrate <small>DDD</small> with <small>XXGDB</small>, invoke <code>xxgdb</code> as
11227
<p>To start a <acronym>DDD</acronym> debugging session in XEmacs, use ‘<samp><span class="samp">M-x gdb</span></samp>’ or
11228
‘<samp><span class="samp">M-x gdbsrc</span></samp>’. Proceed as usual.
11229
11230
<h4 class="subsection">10.3.3 Using DDD with <acronym>XXGDB</acronym></h4>
11231
11232
<p><a name="index-g_t_0040acronym_007bXXGDB_007d_002c-integrating-_0040DDD_007b_007d-1222"></a><a name="index-xxgdb-1223"></a>To integrate <acronym>DDD</acronym> with <acronym>XXGDB</acronym>, invoke <samp><span class="command">xxgdb</span></samp> as
12802
11233
12803
11234
<pre class="example"> xxgdb -db_name ddd -db_prompt '(gdb) '
12804
</pre>
12805
12806
<div class="node">
11235
</pre>
11236
<div class="node">
12807
11237
<p><hr>
12808
<small class=header>
12809
Node:<a name="Defining%20Buttons">Defining Buttons</a>,
12810
Next:<a rel="next" accesskey="n" href="#Defining%20Commands">Defining Commands</a>,
12811
Previous:<a rel="previous" accesskey="p" href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>,
12812
Up:<a rel="up" accesskey="u" href="#Commands">Commands</a>
11238
<a name="Defining-Buttons"></a>
11239
Next: <a rel="next" accesskey="n" href="#Defining-Commands">Defining Commands</a>,
11240
Previous: <a rel="previous" accesskey="p" href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">Integrating <acronym>DDD</acronym></a>,
11241
Up: <a rel="up" accesskey="u" href="#Commands">Commands</a>
12813
11242
</small>
12814
11243
12815
<br>
11244
12816
11245
</div>
12817
11246
12818
<h3 class="section">Defining Buttons</h3>
12819
12820
<p>To facilitate interaction, you can add own command buttons to
12821
<small>DDD</small>. These buttons can be added below the debugger console
12822
(<code>Console Buttons</code>), the source window (<code>Source Buttons</code>), or
12823
the data window (<code>Data Buttons</code>).
12824
12825
<p>To define individual buttons, use the <em>Button Editor</em>, invoked via
12826
<code>Commands => Edit Buttons</code>. The button editor displays a
11247
<h3 class="section">10.4 Defining Buttons</h3>
11248
11249
<p><a name="index-Buttons_002c-defining-1224"></a>
11250
To facilitate interaction, you can add own command buttons to
11251
<acronym>DDD</acronym>. These buttons can be added below the debugger console
11252
(‘<samp><span class="samp">Console Buttons</span></samp>’), the source window (‘<samp><span class="samp">Source Buttons</span></samp>’), or
11253
the data window (‘<samp><span class="samp">Data Buttons</span></samp>’).
11254
11255
<p><a name="index-Button-editor-1225"></a>To define individual buttons, use the <em>Button Editor</em>, invoked via
11256
‘<samp><span class="samp">Commands Edit Buttons</span></samp>’. The button editor displays a
12827
11257
text, where each line contains the command for exactly one button.
12828
Clicking on <code>OK</code> creates the appropriate buttons from the text. If
11258
Clicking on ‘<samp><span class="samp">OK</span></samp>’ creates the appropriate buttons from the text. If
12829
11259
the text is empty (the default), no button is created.
12830
11260
12831
<p>As a simple example, assume you want to create a <code>print i</code>
12832
button. Invoke <code>Commands => Edit Buttons</code> and enter a line
12833
saying <code>print i</code> in the button editor. Then click on
12834
<code>OK</code>. A button named <code>Print i</code> will now appear below the
12835
debugger console--try it! To remove the button, reopen the button
12836
editor, clear the <code>print i</code> line and press <code>OK</code> again.
11261
<p><a name="index-Edit-Buttons-1226"></a>As a simple example, assume you want to create a ‘<samp><span class="samp">print i</span></samp>’
11262
button. Invoke ‘<samp><span class="samp">Commands Edit Buttons</span></samp>’ and enter a line
11263
saying ‘<samp><span class="samp">print i</span></samp>’ in the button editor. Then click on
11264
‘<samp><span class="samp">OK</span></samp>’. A button named ‘<samp><span class="samp">Print i</span></samp>’ will now appear below the
11265
debugger console—try it! To remove the button, reopen the button
11266
editor, clear the ‘<samp><span class="samp">print i</span></samp>’ line and press ‘<samp><span class="samp">OK</span></samp>’ again.
12837
11267
12838
<p>If a button command contains <code>()</code>, the string <code>()</code> will
11268
<p>If a button command contains ‘<samp><span class="samp">()</span></samp>’, the string ‘<samp><span class="samp">()</span></samp>’ will
12839
11269
automatically be replaced by the contents of the argument field. For
12840
instance, a button named <code>return ()</code> will execute the <small>GDB</small>
12841
<code>return</code> command with the current content of the argument field as
11270
instance, a button named ‘<samp><span class="samp">return ()</span></samp>’ will execute the <acronym>GDB</acronym>
11271
‘<samp><span class="samp">return</span></samp>’ command with the current content of the argument field as
12842
11272
argument.
12843
11273
12844
<p>By default, <small>DDD</small> disables buttons whose commands are not
11274
<p><a name="index-Enable-supported-buttons-only-1227"></a>By default, <acronym>DDD</acronym> disables buttons whose commands are not
12845
11275
supported by the inferior debugger. To enable such buttons, unset the
12846
<code>Enable supported buttons only</code> toggle in the button editor.
12847
12848
<br><p>
11276
‘<samp><span class="samp">Enable supported buttons only</span></samp>’ toggle in the button editor.
11277
11278
<pre class="sp">
11279
11280
</pre>
12849
11281
<div align="center"><img src="PICS/ddd-button-editor.jpg" alt="PICS/ddd-button-editor.jpg"></div>
12850
<br><p>
12851
<p><small>DDD</small> also allows you to specify control sequences and special
12852
labels for user-defined buttons. See <a href="#Customizing%20Buttons">Customizing Buttons</a>, for
11282
<pre class="sp">
11283
11284
</pre>
11285
11286
<acronym>DDD</acronym> also allows you to specify control sequences and special
11287
labels for user-defined buttons. See <a href="#Customizing-Buttons">Customizing Buttons</a>, for
12853
11288
details.
12854
11289
12855
11290
<ul class="menu">
12856
<li><a accesskey="1" href="#Customizing%20Buttons">Customizing Buttons</a>: Adding your own command buttons.
11291
<li><a accesskey="1" href="#Customizing-Buttons">Customizing Buttons</a>: Adding your own command buttons.
12857
11292
</ul>
12858
11293
12859
11294
<div class="node">
12860
11295
<p><hr>
12861
<small class=header>
12862
Node:<a name="Customizing%20Buttons">Customizing Buttons</a>,
12863
Up:<a rel="up" accesskey="u" href="#Defining%20Buttons">Defining Buttons</a>
11296
<a name="Customizing-Buttons"></a>
11297
Up: <a rel="up" accesskey="u" href="#Defining-Buttons">Defining Buttons</a>
12864
11298
</small>
12865
11299
12866
<br>
11300
12867
11301
</div>
12868
11302
12869
<h4 class="subsection">Customizing Buttons</h4>
11303
<h4 class="subsection">10.4.1 Customizing Buttons</h4>
12870
11304
12871
<p><small>DDD</small> allows defining additional command buttons; See <a href="#Defining%20Buttons">Defining Buttons</a>, for doing this interactively. This section describes the
11305
<p><acronym>DDD</acronym> allows defining additional command buttons; See <a href="#Defining-Buttons">Defining Buttons</a>, for doing this interactively. This section describes the
12872
11306
resources that control user-defined buttons.
12873
11307
12874
<p>
12875
<table width="100%">
12876
<tr>
12877
<td align="left"><b>consoleButtons</b><i> </i>(<i>class Buttons</i>)<i>
12878
</i></td>
12879
<td align="right">Resource</td>
12880
</tr>
12881
</table>
12882
<table width="95%" align="center">
12883
<tr><td>
12884
A newline-separated list of buttons to be added under the debugger
11308
<div class="defun">
11309
— Resource: <b>consoleButtons</b> (<var>class Buttons</var>)<var><a name="index-consoleButtons-1228"></a></var><br>
11310
<blockquote><p>A newline-separated list of buttons to be added under the debugger
12885
11311
console. Each button issues the command given by its name.
12886
11312
12887
<p>The following characters have special meanings:
11313
<p>The following characters have special meanings:
12888
11314
<ul>
12889
11315
<li>Commands ending with <code>...</code> insert their name, followed by a
12890
11316
space, in the debugger console.
12891
11317
12892
<li>Commands ending with a control character (that is, <code>^</code> followed
12893
by a letter or <code>?</code>) insert the given control character.
12894
12895
<li>The string <code>()</code> is replaced by the current contents
12896
of the argument field <code>()</code>.
12897
12898
<li>The string specified in the <code>labelDelimiter</code> resource (usually
12899
<code>//</code>) separates the command name from the button label. If no
11318
<li>Commands ending with a control character (that is, ‘<samp><span class="samp">^</span></samp>’ followed
11319
by a letter or ‘<samp><span class="samp">?</span></samp>’) insert the given control character.
11320
11321
<li>The string ‘<samp><span class="samp">()</span></samp>’ is replaced by the current contents
11322
of the argument field ‘<samp><span class="samp">()</span></samp>’.
11323
11324
<li>The string specified in the ‘<samp><span class="samp">labelDelimiter</span></samp>’ resource (usually
11325
‘<samp><span class="samp">//</span></samp>’) separates the command name from the button label. If no
12900
11326
button label is specified, the capitalized command will be used as
12901
11327
button label.
12902
11328
</ul>
12903
11329
12904
<p>The following button names are reserved:
11330
<p>The following button names are reserved:
12905
11331
12906
11332
<dl>
12907
<dt><code>Apply</code>
12908
<dd>Send the given command to the debugger.
12909
12910
<br><dt><code>Back</code>
12911
<dd>Lookup previously selected source position.
12912
12913
<br><dt><code>Clear</code>
12914
<dd>Clear current command
12915
12916
<br><dt><code>Complete</code>
12917
<dd>Complete current command.
12918
12919
<br><dt><code>Edit</code>
12920
<dd>Edit current source file.
12921
12922
<br><dt><code>Forward</code>
12923
<dd>Lookup next selected source position.
12924
12925
<br><dt><code>Make</code>
12926
<dd>Invoke the <code>make</code> program, using the most recently given arguments.
12927
12928
<br><dt><code>Next</code>
12929
<dd>Show next command
12930
12931
<br><dt><code>No</code>
12932
<dd>Answer current debugger prompt with <code>no</code>. This button is
11333
<dt>‘<samp><span class="samp">Apply</span></samp>’<dd>Send the given command to the debugger.
11334
11335
<br><dt>‘<samp><span class="samp">Back</span></samp>’<dd>Lookup previously selected source position.
11336
11337
<br><dt>‘<samp><span class="samp">Clear</span></samp>’<dd>Clear current command
11338
11339
<br><dt>‘<samp><span class="samp">Complete</span></samp>’<dd>Complete current command.
11340
11341
<br><dt>‘<samp><span class="samp">Edit</span></samp>’<dd>Edit current source file.
11342
11343
<br><dt>‘<samp><span class="samp">Forward</span></samp>’<dd>Lookup next selected source position.
11344
11345
<br><dt>‘<samp><span class="samp">Make</span></samp>’<dd>Invoke the ‘<samp><span class="samp">make</span></samp>’ program, using the most recently given arguments.
11346
11347
<br><dt>‘<samp><span class="samp">Next</span></samp>’<dd>Show next command
11348
11349
<br><dt>‘<samp><span class="samp">No</span></samp>’<dd>Answer current debugger prompt with ‘<samp><span class="samp">no</span></samp>’. This button is
12933
11350
visible only if the debugger asks a yes/no question.
12934
11351
12935
<br><dt><code>Prev</code>
12936
<dd>Show previous command
12937
12938
<br><dt><code>Reload</code>
12939
<dd>Reload source file.
12940
12941
<br><dt><code>Yes</code>
12942
<dd>Answer current debugger prompt with <code>yes</code>. This button is
11352
<br><dt>‘<samp><span class="samp">Prev</span></samp>’<dd>Show previous command
11353
11354
<br><dt>‘<samp><span class="samp">Reload</span></samp>’<dd>Reload source file.
11355
11356
<br><dt>‘<samp><span class="samp">Yes</span></samp>’<dd>Answer current debugger prompt with ‘<samp><span class="samp">yes</span></samp>’. This button is
12943
11357
visible only if the debugger asks a yes/no question.
12944
11358
</dl>
12945
11359
12946
<p>The default resource value is empty--no console buttons are
11360
<p>The default resource value is empty—no console buttons are
12947
11361
created.
12948
11362
12949
<p>Here are some examples to insert into your <code>~/.ddd/init</code> file.
12950
These are the settings of <small>DDD</small> 1.x:
11363
<p>Here are some examples to insert into your <samp><span class="file">~/.ddd/init</span></samp> file.
11364
These are the settings of <acronym>DDD</acronym> 1.x:
12951
11365
<pre class="example"> Ddd*consoleButtons: Yes\nNo\nbreak^C
12952
</pre>
12953
12954
<p>This setting creates some more buttons:
11366
</pre>
11367
<p>This setting creates some more buttons:
12955
11368
<pre class="example"> Ddd*consoleButtons: \
12956
11369
Yes\nNo\nrun\nClear\nPrev\nNext\nApply\nbreak^C
12957
</pre>
12958
12959
<p>See also the <code>dataButtons</code>, <code>sourceButtons</code> and
12960
<code>toolButtons</code> resources.
12961
</td></tr>
12962
</table>
12963
12964
<p>
12965
<table width="100%">
12966
<tr>
12967
<td align="left"><b>dataButtons</b><i> </i>(<i>class Buttons</i>)<i>
12968
</i></td>
12969
<td align="right">Resource</td>
12970
</tr>
12971
</table>
12972
<table width="95%" align="center">
12973
<tr><td>
12974
A newline-separated list of buttons to be added under the data display.
11370
</pre>
11371
<p>See also the ‘<samp><span class="samp">dataButtons</span></samp>’, ‘<samp><span class="samp">sourceButtons</span></samp>’ and
11372
‘<samp><span class="samp">toolButtons</span></samp>’ resources.
11373
</p></blockquote></div>
11374
11375
<div class="defun">
11376
— Resource: <b>dataButtons</b> (<var>class Buttons</var>)<var><a name="index-dataButtons-1229"></a></var><br>
11377
<blockquote><p>A newline-separated list of buttons to be added under the data display.
12975
11378
Each button issues the command given by its name. See the
12976
<code>consoleButtons</code> resource, above, for details on button syntax.
11379
‘<samp><span class="samp">consoleButtons</span></samp>’ resource, above, for details on button syntax.
12977
11380
12978
<p>The default resource value is empty--no source buttons are
11381
<p>The default resource value is empty—no source buttons are
12979
11382
created.
12980
</td></tr>
12981
</table>
11383
</p></blockquote></div>
12982
11384
12983
<p>
12984
<table width="100%">
12985
<tr>
12986
<td align="left"><b>sourceButtons</b><i> </i>(<i>class Buttons</i>)<i>
12987
</i></td>
12988
<td align="right">Resource</td>
12989
</tr>
12990
</table>
12991
<table width="95%" align="center">
12992
<tr><td>
12993
A newline-separated list of buttons to be added under the debugger
11385
<div class="defun">
11386
— Resource: <b>sourceButtons</b> (<var>class Buttons</var>)<var><a name="index-sourceButtons-1230"></a></var><br>
11387
<blockquote><p>A newline-separated list of buttons to be added under the debugger
12994
11388
console. Each button issues the command given by its name. See the
12995
<code>consoleButtons</code> resource, above, for details on button syntax.
11389
‘<samp><span class="samp">consoleButtons</span></samp>’ resource, above, for details on button syntax.
12996
11390
12997
<p>The default resource value is empty--no source buttons are
11391
<p>The default resource value is empty—no source buttons are
12998
11392
created.
12999
11393
13000
<p>Here are some example to insert into your <code>~/.ddd/init</code> file.
13001
These are the settings of <small>DDD</small> 1.x:
11394
<p>Here are some example to insert into your <samp><span class="file">~/.ddd/init</span></samp> file.
11395
These are the settings of <acronym>DDD</acronym> 1.x:
13002
11396
13003
11397
<pre class="example"> Ddd*sourceButtons: \
13004
11398
run\nstep\nnext\nstepi\nnexti\ncont\n\
13005
11399
finish\nkill\nup\ndown\n\
13006
11400
Back\nForward\nEdit\ninterrupt^C
13007
</pre>
13008
13009
<p>This setting creates some buttons which are not found on the command tool:
11401
</pre>
11402
<p>This setting creates some buttons which are not found on the command tool:
13010
11403
13011
11404
<pre class="example"> Ddd*sourceButtons: \
13012
11405
print *()\ngraph display *()\nprint /x ()\n\
13013
11406
whatis ()\nptype ()\nwatch ()\nuntil\nshell
13014
</pre>
13015
13016
<p>An even more professional setting uses customized button labels.
11407
</pre>
11408
<p>An even more professional setting uses customized button labels.
13017
11409
13018
11410
<pre class="example"> Ddd*sourceButtons: \
13019
11411
print *(()) // Print *()\n\
13024
11416
watch ()\n\
13025
11417
until\n\
13026
11418
shell
13027
</pre>
13028
13029
<p>See also the <code>consoleButtons</code> and <code>dataButtons</code> resources,
13030
above, and the <code>toolButtons</code> resource, below.
13031
</td></tr>
13032
</table>
13033
13034
<p>
13035
<table width="100%">
13036
<tr>
13037
<td align="left"><b>toolButtons</b><i> </i>(<i>class Buttons</i>)<i>
13038
</i></td>
13039
<td align="right">Resource</td>
13040
</tr>
13041
</table>
13042
<table width="95%" align="center">
13043
<tr><td>
13044
A newline-separated list of buttons to be included in the command tool
13045
or the command tool bar (see <a href="#Disabling%20the%20Command%20Tool">Disabling the Command Tool</a>). Each
13046
button issues the command given by its name. See <a href="#Defining%20Buttons">Defining Buttons</a>,
11419
</pre>
11420
<p>See also the ‘<samp><span class="samp">consoleButtons</span></samp>’ and ‘<samp><span class="samp">dataButtons</span></samp>’ resources,
11421
above, and the ‘<samp><span class="samp">toolButtons</span></samp>’ resource, below.
11422
</p></blockquote></div>
11423
11424
<div class="defun">
11425
— Resource: <b>toolButtons</b> (<var>class Buttons</var>)<var><a name="index-toolButtons-1231"></a></var><br>
11426
<blockquote><p>A newline-separated list of buttons to be included in the command tool
11427
or the command tool bar (see <a href="#Disabling-the-Command-Tool">Disabling the Command Tool</a>). Each
11428
button issues the command given by its name. See <a href="#Defining-Buttons">Defining Buttons</a>,
13047
11429
for details on button syntax.
13048
11430
13049
<p>The default resource value is
11431
<p>The default resource value is
13050
11432
13051
11433
<pre class="example"> Ddd*toolButtons: \
13052
11434
run\nbreak^C\nstep\nstepi\nnext\nnexti\n\
13053
11435
until\nfinish\ncont\n\kill\n\
13054
11436
up\ndown\nBack\nForward\nEdit\nMake
13055
</pre>
13056
13057
<p>For each button, its location in the command tool must be specified
13058
using <code>XmForm</code> constraint resources. See the <code>Ddd</code>
11437
</pre>
11438
<p>For each button, its location in the command tool must be specified
11439
using ‘<samp><span class="samp">XmForm</span></samp>’ constraint resources. See the ‘<samp><span class="samp">Ddd</span></samp>’
13059
11440
application defaults file for instructions.
13060
11441
13061
<p>If the <code>toolButtons</code> resource value is empty, the command tool is
11442
<p>If the ‘<samp><span class="samp">toolButtons</span></samp>’ resource value is empty, the command tool is
13062
11443
not created.
13063
</td></tr>
13064
</table>
11444
</p></blockquote></div>
13065
11445
13066
11446
<p>The following resources set up button details:
13067
11447
13068
<p>
13069
<table width="100%">
13070
<tr>
13071
<td align="left"><b>labelDelimiter</b><i> </i>(<i>class LabelDelimiter</i>)<i>
13072
</i></td>
13073
<td align="right">Resource</td>
13074
</tr>
13075
</table>
13076
<table width="95%" align="center">
13077
<tr><td>
13078
The string used to separate labels from commands and shortcuts.
13079
Default is <code>//</code>.
13080
</td></tr>
13081
</table>
11448
<div class="defun">
11449
— Resource: <b>labelDelimiter</b> (<var>class LabelDelimiter</var>)<var><a name="index-labelDelimiter-1232"></a></var><br>
11450
<blockquote><p>The string used to separate labels from commands and shortcuts.
11451
Default is ‘<samp><span class="samp">//</span></samp>’.
11452
</p></blockquote></div>
13082
11453
13083
<p>
13084
<table width="100%">
13085
<tr>
13086
<td align="left"><b>verifyButtons</b><i> </i>(<i>class VerifyButtons</i>)<i>
13087
</i></td>
13088
<td align="right">Resource</td>
13089
</tr>
13090
</table>
13091
<table width="95%" align="center">
13092
<tr><td>
13093
If <code>on</code> (default), verify for each button whether its command is
11454
<div class="defun">
11455
— Resource: <b>verifyButtons</b> (<var>class VerifyButtons</var>)<var><a name="index-verifyButtons-1233"></a></var><br>
11456
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), verify for each button whether its command is
13094
11457
actually supported by the inferior debugger. If the command is unknown,
13095
the button is disabled. If this resource is <code>off</code>, no checking is
13096
done: all commands are accepted "as is".
13097
</td></tr>
13098
</table>
11458
the button is disabled. If this resource is ‘<samp><span class="samp">off</span></samp>’, no checking is
11459
done: all commands are accepted “as is”.
11460
</p></blockquote></div>
13099
11461
13100
11462
<div class="node">
13101
11463
<p><hr>
13102
<small class=header>
13103
Node:<a name="Defining%20Commands">Defining Commands</a>,
13104
Previous:<a rel="previous" accesskey="p" href="#Defining%20Buttons">Defining Buttons</a>,
13105
Up:<a rel="up" accesskey="u" href="#Commands">Commands</a>
11464
<a name="Defining-Commands"></a>
11465
Previous: <a rel="previous" accesskey="p" href="#Defining-Buttons">Defining Buttons</a>,
11466
Up: <a rel="up" accesskey="u" href="#Commands">Commands</a>
13106
11467
</small>
13107
11468
13108
<br>
11469
13109
11470
</div>
13110
11471
13111
<h3 class="section">Defining Commands</h3>
11472
<h3 class="section">10.5 Defining Commands</h3>
13112
11473
13113
<p>Aside from breakpoint commands (see <a href="#Breakpoint%20Commands">Breakpoint Commands</a>),
13114
<small>DDD</small> also allows you to define user-defined commands. A
11474
<p><a name="index-Command_002c-defining-1234"></a><a name="index-Command_002c-user_002ddefined-1235"></a><a name="index-User_002ddefined-command-1236"></a>
11475
Aside from breakpoint commands (see <a href="#Breakpoint-Commands">Breakpoint Commands</a>),
11476
<acronym>DDD</acronym> also allows you to define user-defined commands. A
13115
11477
<em>user-defined command</em> is a sequence of commands to which you
13116
11478
assign a new name as a command. This new command can be entered at the
13117
11479
debugger prompt or invoked via a button.
13118
11480
13119
11481
<ul class="menu">
13120
<li><a accesskey="1" href="#GDB%20Simple%20Commands">GDB Simple Commands</a>:
13121
<li><a accesskey="2" href="#GDB%20Argument%20Commands">GDB Argument Commands</a>:
13122
<li><a accesskey="3" href="#Commands%20with%20Other%20Debuggers">Commands with Other Debuggers</a>:
11482
<li><a accesskey="1" href="#GDB-Simple-Commands">GDB Simple Commands</a>
11483
<li><a accesskey="2" href="#GDB-Argument-Commands">GDB Argument Commands</a>
11484
<li><a accesskey="3" href="#Commands-with-Other-Debuggers">Commands with Other Debuggers</a>
13123
11485
</ul>
13124
11486
13125
11487
<div class="node">
13126
11488
<p><hr>
13127
<small class=header>
13128
Node:<a name="GDB%20Simple%20Commands">GDB Simple Commands</a>,
13129
Next:<a rel="next" accesskey="n" href="#GDB%20Argument%20Commands">GDB Argument Commands</a>,
13130
Up:<a rel="up" accesskey="u" href="#Defining%20Commands">Defining Commands</a>
11489
<a name="GDB-Simple-Commands"></a>
11490
Next: <a rel="next" accesskey="n" href="#GDB-Argument-Commands">GDB Argument Commands</a>,
11491
Up: <a rel="up" accesskey="u" href="#Defining-Commands">Defining Commands</a>
13131
11492
</small>
13132
11493
13133
<br>
11494
13134
11495
</div>
13135
11496
13136
<h4 class="subsection">Defining Simple Commands using GDB</h4>
13137
13138
<p>Aside from breakpoint commands (see <code>Breakpoint commands</code>,
13139
above), <small>DDD</small> also allows you to store sequences of commands
13140
as a user-defined <small>GDB</small> command. A <em>user-defined command</em>
13141
is a sequence of <small>GDB</small> commands to which you assign a new name
13142
as a command. Using <small>DDD</small>, this is done via the <em>Command
13143
Editor</em>, invoked via <code>Commands => Define Command</code>.
13144
13145
<p>A <small>GDB</small> command is created in five steps:
11497
<h4 class="subsection">10.5.1 Defining Simple Commands using GDB</h4>
11498
11499
<p><a name="index-Command_002c-defining-in-_0040GDB_007b_007d-1237"></a>
11500
Aside from breakpoint commands (see ‘<samp><span class="samp">Breakpoint commands</span></samp>’,
11501
above), <acronym>DDD</acronym> also allows you to store sequences of commands
11502
as a user-defined <acronym>GDB</acronym> command. A <em>user-defined command</em>
11503
is a sequence of <acronym>GDB</acronym> commands to which you assign a new name
11504
as a command. Using <acronym>DDD</acronym>, this is done via the <em>Command
11505
Editor</em>, invoked via ‘<samp><span class="samp">Commands Define Command</span></samp>’.
11506
11507
<p>A <acronym>GDB</acronym> command is created in five steps:
13146
11508
13147
11509
<ol type=1 start=1>
13148
<li>Enter the name of the command in the <code>Command</code> field. Use the
11510
<li><a name="index-Command-1238"></a>Enter the name of the command in the ‘<samp><span class="samp">Command</span></samp>’ field. Use the
13149
11511
drop-down list on the right to select from already defined commands.
13150
11512
13151
<li>Click on <code>Record</code> to begin the recording of the command sequence.
11513
<li><a name="index-Record-1239"></a><a name="index-Recording-commands-1240"></a><a name="index-Command_002c-recording-1241"></a>Click on ‘<samp><span class="samp">Record</span></samp>’ to begin the recording of the command sequence.
13152
11514
13153
<li>Now interact with <small>DDD</small>. While recording, <small>DDD</small> does not
11515
<li>Now interact with <acronym>DDD</acronym>. While recording, <acronym>DDD</acronym> does not
13154
11516
execute commands, but simply records them to be executed when the
13155
11517
breakpoint is hit. The recorded debugger commands are shown in the
13156
11518
debugger console.
13157
11519
13158
<li>To stop the recording, click on <code>End</code> or enter <code>end</code> at
13159
the <small>GDB</small> prompt. To <em>cancel</em> the recording, click on
13160
<code>Interrupt</code> or press <ESC>.
11520
<li><a name="index-End-1242"></a>To stop the recording, click on ‘<samp><span class="samp">End</span></samp>’ or enter ‘<samp><span class="samp">end</span></samp>’ at
11521
the <acronym>GDB</acronym> prompt. To <em>cancel</em> the recording, click on
11522
‘<samp><span class="samp">Interrupt</span></samp>’ or press <ESC>.
13161
11523
13162
<li>Click on <code>Edit >></code> to edit the recorded commands.
13163
When done with editing, click on <code>Edit <<</code> to close the
11524
<li><a name="index-Edit-_003e_003e-1243"></a><a name="index-Edit-_003c_003c-1244"></a>Click on ‘<samp><span class="samp">Edit >></span></samp>’ to edit the recorded commands.
11525
When done with editing, click on ‘<samp><span class="samp">Edit <<</span></samp>’ to close the
13164
11526
commands editor.
13165
11527
</ol>
13166
11528
13167
<p>After the command is defined, you can enter it at the <small>GDB</small> prompt. You
13168
may also click on <code>Execute</code> to test the given user-defined command.
11529
<p><a name="index-Execute-1245"></a>After the command is defined, you can enter it at the <acronym>GDB</acronym> prompt. You
11530
may also click on ‘<samp><span class="samp">Execute</span></samp>’ to test the given user-defined command.
13169
11531
13170
<p>For convenience, you can assign a button to the defined command.
13171
Enabling one of the <code>Button</code> locations will add a button with the
11532
<p><a name="index-Button-1246"></a>For convenience, you can assign a button to the defined command.
11533
Enabling one of the ‘<samp><span class="samp">Button</span></samp>’ locations will add a button with the
13172
11534
given command to the specified location. If you want to edit the
13173
button, select <code>Commands => Edit Buttons</code>. See <a href="#Defining%20Buttons">Defining Buttons</a>, for a discussion.
13174
13175
<br><p>
11535
button, select ‘<samp><span class="samp">Commands Edit Buttons</span></samp>’. See <a href="#Defining-Buttons">Defining Buttons</a>, for a discussion.
11536
11537
<pre class="sp">
11538
11539
</pre>
13176
11540
<div align="center"><img src="PICS/ddd-define-command.jpg" alt="PICS/ddd-define-command.jpg"></div>
13177
<br><p>
13178
<p>When user-defined <small>GDB</small> commands are executed, the commands of the
11541
<pre class="sp">
11542
11543
</pre>
11544
11545
When user-defined <acronym>GDB</acronym> commands are executed, the commands of the
13179
11546
definition are not printed. An error in any command stops execution of
13180
the user-defined command.<a rel="footnote" href="#fn-32"><sup>32</sup></a>
11547
the user-defined command.<a rel="footnote" href="#fn-32" name="fnd-32"><sup>32</sup></a>
13181
11548
13182
11549
<p>If used interactively, commands that would ask for confirmation
13183
11550
proceed without asking when used inside a user-defined command. Many
13184
<small>GDB</small> commands that normally print messages to say what they are
11551
<acronym>GDB</acronym> commands that normally print messages to say what they are
13185
11552
doing omit the messages when used in a user-defined command.
13186
11553
13187
<p>Command definitions are saved across <small>DDD</small> sessions.
11554
<p>Command definitions are saved across <acronym>DDD</acronym> sessions.
13188
11555
13189
11556
<div class="node">
13190
11557
<p><hr>
13191
<small class=header>
13192
Node:<a name="GDB%20Argument%20Commands">GDB Argument Commands</a>,
13193
Next:<a rel="next" accesskey="n" href="#Commands%20with%20Other%20Debuggers">Commands with Other Debuggers</a>,
13194
Previous:<a rel="previous" accesskey="p" href="#GDB%20Simple%20Commands">GDB Simple Commands</a>,
13195
Up:<a rel="up" accesskey="u" href="#Defining%20Commands">Defining Commands</a>
11558
<a name="GDB-Argument-Commands"></a>
11559
Next: <a rel="next" accesskey="n" href="#Commands-with-Other-Debuggers">Commands with Other Debuggers</a>,
11560
Previous: <a rel="previous" accesskey="p" href="#GDB-Simple-Commands">GDB Simple Commands</a>,
11561
Up: <a rel="up" accesskey="u" href="#Defining-Commands">Defining Commands</a>
13196
11562
</small>
13197
11563
13198
<br>
11564
13199
11565
</div>
13200
11566
13201
<h4 class="subsection">Defining Argument Commands using GDB</h4>
11567
<h4 class="subsection">10.5.2 Defining Argument Commands using GDB</h4>
13202
11568
13203
<p>If you want to pass arguments to user-defined commands, you can enable
13204
the <code>()</code> toggle button in the Command Editor. Enabling
13205
<code>()</code> has two effects:
11569
<p><a name="index-Command_002c-argument-1247"></a>
11570
<a name="index-g_t_0028_0029-1248"></a>If you want to pass arguments to user-defined commands, you can enable
11571
the ‘<samp><span class="samp">()</span></samp>’ toggle button in the Command Editor. Enabling
11572
‘<samp><span class="samp">()</span></samp>’ has two effects:
13206
11573
13207
11574
<ul>
13208
11575
<li>While recording commands, all references to the argument field are taken
13209
11576
<em>symbolically</em> instead of literally. The argument field value is
13210
frozen to <code>$arg0</code>, which is how <small>GDB</small> denotes the argument of a
13211
user-defined command. When <small>GDB</small> executes the command, it will replace
13212
<code>$arg0</code> by the current command argument.
11577
frozen to ‘<samp><span class="samp">$arg0</span></samp>’, which is how <acronym>GDB</acronym> denotes the argument of a
11578
user-defined command. When <acronym>GDB</acronym> executes the command, it will replace
11579
‘<samp><span class="samp">$arg0</span></samp>’ by the current command argument.
13213
11580
13214
11581
<li>When assigning a button to the command, the command will be suffixed by
13215
11582
the current contents of the argument field.
13216
11583
</ul>
13217
11584
13218
<p>While defining a command, you can toggle the <code>()</code> button as you
11585
<p>While defining a command, you can toggle the ‘<samp><span class="samp">()</span></samp>’ button as you
13219
11586
wish to switch between using the argument field symbolically and
13220
11587
literally.
13221
11588
13222
<p>As an example, let us define a command <code>contuntil</code> that will set a
11589
<p><a name="index-contuntil-1249"></a>As an example, let us define a command <samp><span class="command">contuntil</span></samp> that will set a
13223
11590
breakpoint in the given argument and continue execution.
13224
11591
13225
11592
<ol type=1 start=1>
13226
<li>Enter <code>contuntil</code> in the <code>Command</code> field.
13227
13228
<li>Enable the <code>()</code> toggle button.
13229
13230
<li>Now click on <code>Record</code> to start recording. Note that the
13231
contents of the argument field change to <code>$arg0</code>.
13232
13233
<li>Click on <code>Break at ()</code> to create a breakpoint. Note that the
13234
recorded breakpoint command refers to <code>$arg0</code>.
13235
13236
<li>Click on <code>Cont</code> to continue execution.
13237
13238
<li>Click on <code>End</code> to end recording. Note that the argument field
11593
<li>Enter ‘<samp><span class="samp">contuntil</span></samp>’ in the ‘<samp><span class="samp">Command</span></samp>’ field.
11594
11595
<li>Enable the ‘<samp><span class="samp">()</span></samp>’ toggle button.
11596
11597
<li>Now click on ‘<samp><span class="samp">Record</span></samp>’ to start recording. Note that the
11598
contents of the argument field change to ‘<samp><span class="samp">$arg0</span></samp>’.
11599
11600
<li>Click on ‘<samp><span class="samp">Break at ()</span></samp>’ to create a breakpoint. Note that the
11601
recorded breakpoint command refers to ‘<samp><span class="samp">$arg0</span></samp>’.
11602
11603
<li>Click on ‘<samp><span class="samp">Cont</span></samp>’ to continue execution.
11604
11605
<li>Click on ‘<samp><span class="samp">End</span></samp>’ to end recording. Note that the argument field
13239
11606
is restored to its original value.
13240
11607
13241
<li>Finally, click on one of the <code>Button</code> locations. This creates a
13242
<code>Contuntil ()</code> button where <code>()</code> will be replaced by the
13243
current contents of the argument field--and thus passed to the
13244
<code>contuntil</code> command.
11608
<li>Finally, click on one of the ‘<samp><span class="samp">Button</span></samp>’ locations. This creates a
11609
‘<samp><span class="samp">Contuntil ()</span></samp>’ button where ‘<samp><span class="samp">()</span></samp>’ will be replaced by the
11610
current contents of the argument field—and thus passed to the
11611
‘<samp><span class="samp">contuntil</span></samp>’ command.
13245
11612
13246
<li>You can now either use the <code>Contuntil ()</code> button or enter a
13247
<code>contuntil</code> command at the <small>GDB</small> prompt. (If you plan to
13248
use the command frequently, you may wish to define a <code>cu</code>
13249
command, which again calls <code>contuntil</code> with its argument. This
11613
<li>You can now either use the ‘<samp><span class="samp">Contuntil ()</span></samp>’ button or enter a
11614
‘<samp><span class="samp">contuntil</span></samp>’ command at the <acronym>GDB</acronym> prompt. (If you plan to
11615
use the command frequently, you may wish to define a ‘<samp><span class="samp">cu</span></samp>’
11616
command, which again calls ‘<samp><span class="samp">contuntil</span></samp>’ with its argument. This
13250
11617
is a nice exercise.)
13251
11618
</ol>
13252
11619
13253
11620
<p>There is a little drawback with argument commands: a user-defined
13254
command in <small>GDB</small> has no means to access the argument list as a whole; only
11621
command in <acronym>GDB</acronym> has no means to access the argument list as a whole; only
13255
11622
the first argument (up to whitespace) is processed. This may change in
13256
future <small>GDB</small> releases.
11623
future <acronym>GDB</acronym> releases.
13257
11624
13258
11625
<div class="node">
13259
11626
<p><hr>
13260
<small class=header>
13261
Node:<a name="Commands%20with%20Other%20Debuggers">Commands with Other Debuggers</a>,
13262
Previous:<a rel="previous" accesskey="p" href="#GDB%20Argument%20Commands">GDB Argument Commands</a>,
13263
Up:<a rel="up" accesskey="u" href="#Defining%20Commands">Defining Commands</a>
11627
<a name="Commands-with-Other-Debuggers"></a>
11628
Previous: <a rel="previous" accesskey="p" href="#GDB-Argument-Commands">GDB Argument Commands</a>,
11629
Up: <a rel="up" accesskey="u" href="#Defining-Commands">Defining Commands</a>
13264
11630
</small>
13265
11631
13266
<br>
11632
13267
11633
</div>
13268
11634
13269
<h4 class="subsection">Defining Commands using Other Debuggers</h4>
11635
<h4 class="subsection">10.5.3 Defining Commands using Other Debuggers</h4>
13270
11636
13271
<p>If your inferior debugger allows you to define own command sequences,
13272
you can also use these user-defined commands within <small>DDD</small>; just
11637
<p><a name="index-Command_002c-defining-with-other-debuggers-1250"></a>
11638
If your inferior debugger allows you to define own command sequences,
11639
you can also use these user-defined commands within <acronym>DDD</acronym>; just
13273
11640
enter them at the debugger prompt.
13274
11641
13275
11642
<p>However, you may encounter some problems:
13276
11643
13277
11644
<ul>
13278
11645
<li>In contrast to the well-documented commands of the inferior debugger,
13279
<small>DDD</small> does not know what a user-defined command does. This may
13280
lead to inconsistencies between <small>DDD</small> and the inferior debugger.
13281
For instance, if your the user-defined command <code>bp</code> sets a
13282
breakpoint, <small>DDD</small> may not display it immediately, because
13283
<small>DDD</small> does not know that <code>bp</code> changes the breakpoint state.
11646
<acronym>DDD</acronym> does not know what a user-defined command does. This may
11647
lead to inconsistencies between <acronym>DDD</acronym> and the inferior debugger.
11648
For instance, if your the user-defined command ‘<samp><span class="samp">bp</span></samp>’ sets a
11649
breakpoint, <acronym>DDD</acronym> may not display it immediately, because
11650
<acronym>DDD</acronym> does not know that ‘<samp><span class="samp">bp</span></samp>’ changes the breakpoint state.
13284
11651
13285
<li>You cannot use <small>DDD</small> <code>graph</code> commands within user-defined
11652
<li>You cannot use <acronym>DDD</acronym> ‘<samp><span class="samp">graph</span></samp>’ commands within user-defined
13286
11653
commands. This is only natural, because user-defined commands are
13287
11654
interpreted by the inferior debugger, which does not know about
13288
<small>DDD</small> commands.
11655
<acronym>DDD</acronym> commands.
13289
11656
</ul>
13290
11657
13291
<p>As a solution, <small>DDD</small> provides a simple facility called
13292
<dfn>auto-commands</dfn>. If <small>DDD</small> receives any output from the
13293
inferior debugger in the form <code></code><var>prefix</var><code> </code><var>command</var><code></code>, it will
11658
<p><a name="index-Auto_002dcommand-1251"></a><a name="index-Command_002c-auto-1252"></a>As a solution, <acronym>DDD</acronym> provides a simple facility called
11659
<dfn>auto-commands</dfn>. If <acronym>DDD</acronym> receives any output from the
11660
inferior debugger in the form ‘<samp><var>prefix</var> <var>command</var></samp>’, it will
13294
11661
interpret <var>command</var> as if it had been entered at the debugger
13295
11662
prompt. <var>prefix</var> is a user-defined string, for example
13296
<code>ddd: </code>.
11663
‘<samp><span class="samp">ddd: </span></samp>’.
13297
11664
13298
<p>Suppose you want to define a command <code>gd</code> that serves as
13299
abbreviation for <code>graph display</code>. All the command <code>gd</code> has
11665
<p><a name="index-gd-1253"></a>Suppose you want to define a command <samp><span class="command">gd</span></samp> that serves as
11666
abbreviation for <samp><span class="command">graph display</span></samp>. All the command <samp><span class="command">gd</span></samp> has
13300
11667
to do is to issue a string
13301
11668
13302
11669
<pre class="example"> ddd: graph display <var>argument</var>
13303
</pre>
13304
13305
<p>where <var>argument</var> is the argument given to <code>gd</code>. Using
13306
<small>GDB</small>, this can be achieved using the <code>echo</code> command. In
13307
your <code>~/.gdbinit</code> file, insert the lines
11670
</pre>
11671
<p>where <var>argument</var> is the argument given to <samp><span class="command">gd</span></samp>. Using
11672
<acronym>GDB</acronym>, this can be achieved using the <samp><span class="command">echo</span></samp> command. In
11673
your <samp><span class="file">~/.gdbinit</span></samp> file, insert the lines
13308
11674
13309
11675
<pre class="example"> define gd
13310
11676
echo ddd: graph display $arg0\n
13311
11677
end
13312
</pre>
13313
13314
<p>To complete the setting, you must also set the <code>autoCommandPrefix</code>
13315
resource to the <code>ddd: </code> prefix you gave in your command.
13316
In <code>~/.ddd/init</code>, write:
11678
</pre>
11679
<p>To complete the setting, you must also set the ‘<samp><span class="samp">autoCommandPrefix</span></samp>’
11680
resource to the ‘<samp><span class="samp">ddd: </span></samp>’ prefix you gave in your command.
11681
In <samp><span class="file">~/.ddd/init</span></samp>, write:
13317
11682
13318
11683
<pre class="example"> Ddd*autoCommandPrefix: ddd:\
13319
</pre>
13320
13321
<p>(Be sure to leave a space after the trailing backslash.)
13322
13323
<p>Entering <code>gd foo</code> will now have the same effect as entering
13324
<code>graph display foo</code> at the debugger prompt.
11684
</pre>
11685
<p class="noindent">(Be sure to leave a space after the trailing backslash.)
11686
11687
<p>Entering <samp><span class="command">gd foo</span></samp> will now have the same effect as entering
11688
<samp><span class="command">graph display foo</span></samp> at the debugger prompt.
13325
11689
13326
11690
<p>Please note: In your commands, you should choose some other prefix than
13327
<code>ddd: </code>. This is because auto-commands raise a security
11691
‘<samp><span class="samp">ddd: </span></samp>’. This is because auto-commands raise a security
13328
11692
problem, since arbitrary commands can be executed. Just imagine some
13329
malicious program issuing a string like <code></code><var>prefix</var><code> shell rm -fr
13330
~</code> when being debugged! As a consequence, be sure to choose your own
11693
malicious program issuing a string like ‘<samp><var>prefix</var><span class="samp"> shell rm -fr
11694
~</span></samp>’ when being debugged! As a consequence, be sure to choose your own
13331
11695
<var>prefix</var>; it must be at least three characters long.
13332
11696
13333
11697
<div class="node">
13334
11698
<p><hr>
13335
<small class=header>
13336
Node:<a name="Application%20Defaults">Application Defaults</a>,
13337
Next:<a rel="next" accesskey="n" href="#Bugs">Bugs</a>,
13338
Previous:<a rel="previous" accesskey="p" href="#Commands">Commands</a>,
13339
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
11699
<a name="Application-Defaults"></a>
11700
Next: <a rel="next" accesskey="n" href="#Bugs">Bugs</a>,
11701
Previous: <a rel="previous" accesskey="p" href="#Commands">Commands</a>,
11702
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
13340
11703
</small>
13341
11704
13342
<br>
11705
13343
11706
</div>
13344
11707
13345
<h2 class="appendix">Application Defaults</h2>
11708
<h2 class="appendix">Appendix A Application Defaults</h2>
13346
11709
13347
<p>Like any good X citizen, <small>DDD</small> comes with a large
13348
application-defaults file named <code>Ddd</code>. This appendix documents the
13349
actions and images referenced in <code>Ddd</code>, such that you can easily
11710
<p><a name="index-Ddd-1254"></a>Like any good X citizen, <acronym>DDD</acronym> comes with a large
11711
application-defaults file named <samp><span class="file">Ddd</span></samp>. This appendix documents the
11712
actions and images referenced in <samp><span class="file">Ddd</span></samp>, such that you can easily
13350
11713
modify them.
13351
11714
13352
11715
<ul class="menu">
13356
11719
13357
11720
<div class="node">
13358
11721
<p><hr>
13359
<small class=header>
13360
Node:<a name="Actions">Actions</a>,
13361
Next:<a rel="next" accesskey="n" href="#Images">Images</a>,
13362
Up:<a rel="up" accesskey="u" href="#Application%20Defaults">Application Defaults</a>
11722
<a name="Actions"></a>
11723
Next: <a rel="next" accesskey="n" href="#Images">Images</a>,
11724
Up: <a rel="up" accesskey="u" href="#Application-Defaults">Application Defaults</a>
13363
11725
</small>
13364
11726
13365
<br>
11727
13366
11728
</div>
13367
11729
13368
<h3 class="section">Actions</h3>
11730
<h3 class="section">A.1 Actions</h3>
13369
11731
13370
<p>The following <small>DDD</small> actions may be used in translation tables.
11732
<p>The following <acronym>DDD</acronym> actions may be used in translation tables.
13371
11733
13372
11734
<ul class="menu">
13373
<li><a accesskey="1" href="#General%20Actions">General Actions</a>:
13374
<li><a accesskey="2" href="#Data%20Display%20Actions">Data Display Actions</a>:
13375
<li><a accesskey="3" href="#Debugger%20Console%20Actions">Debugger Console Actions</a>:
13376
<li><a accesskey="4" href="#Source%20Window%20Actions">Source Window Actions</a>:
11735
<li><a accesskey="1" href="#General-Actions">General Actions</a>
11736
<li><a accesskey="2" href="#Data-Display-Actions">Data Display Actions</a>
11737
<li><a accesskey="3" href="#Debugger-Console-Actions">Debugger Console Actions</a>
11738
<li><a accesskey="4" href="#Source-Window-Actions">Source Window Actions</a>
13377
11739
</ul>
13378
11740
13379
11741
<div class="node">
13380
11742
<p><hr>
13381
<small class=header>
13382
Node:<a name="General%20Actions">General Actions</a>,
13383
Next:<a rel="next" accesskey="n" href="#Data%20Display%20Actions">Data Display Actions</a>,
13384
Up:<a rel="up" accesskey="u" href="#Actions">Actions</a>
11743
<a name="General-Actions"></a>
11744
Next: <a rel="next" accesskey="n" href="#Data-Display-Actions">Data Display Actions</a>,
11745
Up: <a rel="up" accesskey="u" href="#Actions">Actions</a>
13385
11746
</small>
13386
11747
13387
<br>
11748
13388
11749
</div>
13389
11750
13390
<h4 class="subsection">General Actions</h4>
13391
13392
<p>
13393
<table width="100%">
13394
<tr>
13395
<td align="left"><b>ddd-get-focus</b><i> </i>(<i></i>)<i>
13396
</i></td>
13397
<td align="right">Action</td>
13398
</tr>
13399
</table>
13400
<table width="95%" align="center">
13401
<tr><td>
13402
Assign focus to the element that just received input.
13403
</td></tr>
13404
</table>
13405
13406
<p>
13407
<table width="100%">
13408
<tr>
13409
<td align="left"><b>ddd-next-tab-group</b><i> </i>(<i></i>)<i>
13410
</i></td>
13411
<td align="right">Action</td>
13412
</tr>
13413
</table>
13414
<table width="95%" align="center">
13415
<tr><td>
13416
Assign focus to the next tab group.
13417
</td></tr>
13418
</table>
13419
13420
<p>
13421
<table width="100%">
13422
<tr>
13423
<td align="left"><b>ddd-prev-tab-group</b><i> </i>(<i></i>)<i>
13424
</i></td>
13425
<td align="right">Action</td>
13426
</tr>
13427
</table>
13428
<table width="95%" align="center">
13429
<tr><td>
13430
Assign focus to the previous tab group.
13431
</td></tr>
13432
</table>
13433
13434
<p>
13435
<table width="100%">
13436
<tr>
13437
<td align="left"><b>ddd-previous-tab-group</b><i> </i>(<i></i>)<i>
13438
</i></td>
13439
<td align="right">Action</td>
13440
</tr>
13441
</table>
13442
<table width="95%" align="center">
13443
<tr><td>
13444
Assign focus to the previous tab group.
13445
</td></tr>
13446
</table>
11751
<h4 class="subsection">A.1.1 General Actions</h4>
11752
11753
<div class="defun">
11754
— Action: <b>ddd-get-focus</b> ()<var><a name="index-ddd_002dget_002dfocus-1255"></a></var><br>
11755
<blockquote><p>Assign focus to the element that just received input.
11756
</p></blockquote></div>
11757
11758
<div class="defun">
11759
— Action: <b>ddd-next-tab-group</b> ()<var><a name="index-ddd_002dnext_002dtab_002dgroup-1256"></a></var><br>
11760
<blockquote><p>Assign focus to the next tab group.
11761
</p></blockquote></div>
11762
11763
<div class="defun">
11764
— Action: <b>ddd-prev-tab-group</b> ()<var><a name="index-ddd_002dprev_002dtab_002dgroup-1257"></a></var><br>
11765
<blockquote><p>Assign focus to the previous tab group.
11766
</p></blockquote></div>
11767
11768
<div class="defun">
11769
— Action: <b>ddd-previous-tab-group</b> ()<var><a name="index-ddd_002dprevious_002dtab_002dgroup-1258"></a></var><br>
11770
<blockquote><p>Assign focus to the previous tab group.
11771
</p></blockquote></div>
13447
11772
13448
11773
<div class="node">
13449
11774
<p><hr>
13450
<small class=header>
13451
Node:<a name="Data%20Display%20Actions">Data Display Actions</a>,
13452
Next:<a rel="next" accesskey="n" href="#Debugger%20Console%20Actions">Debugger Console Actions</a>,
13453
Previous:<a rel="previous" accesskey="p" href="#General%20Actions">General Actions</a>,
13454
Up:<a rel="up" accesskey="u" href="#Actions">Actions</a>
11775
<a name="Data-Display-Actions"></a>
11776
Next: <a rel="next" accesskey="n" href="#Debugger-Console-Actions">Debugger Console Actions</a>,
11777
Previous: <a rel="previous" accesskey="p" href="#General-Actions">General Actions</a>,
11778
Up: <a rel="up" accesskey="u" href="#Actions">Actions</a>
13455
11779
</small>
13456
11780
13457
<br>
11781
13458
11782
</div>
13459
11783
13460
<h4 class="subsection">Data Display Actions</h4>
13461
13462
<p>These actions are used in the <small>DDD</small> graph editor.
13463
13464
<p>
13465
<table width="100%">
13466
<tr>
13467
<td align="left"><b>end</b><i> </i>(<i></i>)<i>
13468
</i></td>
13469
<td align="right">Action</td>
13470
</tr>
13471
</table>
13472
<table width="95%" align="center">
13473
<tr><td>
13474
End the action initiated by <code>select</code>. Bound to a button up event.
13475
</td></tr>
13476
</table>
13477
13478
<p>
13479
<table width="100%">
13480
<tr>
13481
<td align="left"><b>extend</b><i> </i>(<i></i>)<i>
13482
</i></td>
13483
<td align="right">Action</td>
13484
</tr>
13485
</table>
13486
<table width="95%" align="center">
13487
<tr><td>
13488
Extend the current selection. Bound to a button down event.
13489
</td></tr>
13490
</table>
13491
13492
<p>
13493
<table width="100%">
13494
<tr>
13495
<td align="left"><b>extend-or-move</b><i> </i>(<i></i>)<i>
13496
</i></td>
13497
<td align="right">Action</td>
13498
</tr>
13499
</table>
13500
<table width="95%" align="center">
13501
<tr><td>
13502
Extend the current selection. Bound to a button down event.
11784
<h4 class="subsection">A.1.2 Data Display Actions</h4>
11785
11786
<p>These actions are used in the <acronym>DDD</acronym> graph editor.
11787
11788
<div class="defun">
11789
— Action: <b>end</b> ()<var><a name="index-end-1259"></a></var><br>
11790
<blockquote><p>End the action initiated by <code>select</code>. Bound to a button up event.
11791
</p></blockquote></div>
11792
11793
<div class="defun">
11794
— Action: <b>extend</b> ()<var><a name="index-extend-1260"></a></var><br>
11795
<blockquote><p>Extend the current selection. Bound to a button down event.
11796
</p></blockquote></div>
11797
11798
<div class="defun">
11799
— Action: <b>extend-or-move</b> ()<var><a name="index-extend_002dor_002dmove-1261"></a></var><br>
11800
<blockquote><p>Extend the current selection. Bound to a button down event.
13503
11801
If the pointer is dragged, move the selection.
13504
</td></tr>
13505
</table>
11802
</p></blockquote></div>
13506
11803
13507
<p>
13508
<table width="100%">
13509
<tr>
13510
<td align="left"><b>follow</b><i> </i>(<i></i>)<i>
13511
</i></td>
13512
<td align="right">Action</td>
13513
</tr>
13514
</table>
13515
<table width="95%" align="center">
13516
<tr><td>
13517
Continue the action initiated by <code>select</code>. Bound to a pointer
11804
<div class="defun">
11805
— Action: <b>follow</b> ()<var><a name="index-follow-1262"></a></var><br>
11806
<blockquote><p>Continue the action initiated by <code>select</code>. Bound to a pointer
13518
11807
motion event.
13519
</td></tr>
13520
</table>
13521
13522
<p>
13523
<table width="100%">
13524
<tr>
13525
<td align="left"><b>graph-select</b><i> </i>(<i></i>)<i>
13526
</i></td>
13527
<td align="right">Action</td>
13528
</tr>
13529
</table>
13530
<table width="95%" align="center">
13531
<tr><td>
13532
Equivalent to <code>select</code>, but also updates the current argument.
13533
</td></tr>
13534
</table>
13535
13536
<p>
13537
<table width="100%">
13538
<tr>
13539
<td align="left"><b>graph-select-or-move</b><i> </i>(<i></i>)<i>
13540
</i></td>
13541
<td align="right">Action</td>
13542
</tr>
13543
</table>
13544
<table width="95%" align="center">
13545
<tr><td>
13546
Equivalent to <code>select-or-move</code>, but also updates the current argument.
13547
</td></tr>
13548
</table>
13549
13550
<p>
13551
<table width="100%">
13552
<tr>
13553
<td align="left"><b>graph-extend</b><i> </i>(<i></i>)<i>
13554
</i></td>
13555
<td align="right">Action</td>
13556
</tr>
13557
</table>
13558
<table width="95%" align="center">
13559
<tr><td>
13560
Equivalent to <code>extend</code>, but also updates the current argument.
13561
</td></tr>
13562
</table>
13563
13564
<p>
13565
<table width="100%">
13566
<tr>
13567
<td align="left"><b>graph-extend-or-move</b><i> </i>(<i></i>)<i>
13568
</i></td>
13569
<td align="right">Action</td>
13570
</tr>
13571
</table>
13572
<table width="95%" align="center">
13573
<tr><td>
13574
Equivalent to <code>extend-or-move</code>, but also updates the current argument.
13575
</td></tr>
13576
</table>
13577
13578
<p>
13579
<table width="100%">
13580
<tr>
13581
<td align="left"><b>graph-toggle</b><i> </i>(<i></i>)<i>
13582
</i></td>
13583
<td align="right">Action</td>
13584
</tr>
13585
</table>
13586
<table width="95%" align="center">
13587
<tr><td>
13588
Equivalent to <code>toggle</code>, but also updates the current argument.
13589
</td></tr>
13590
</table>
13591
13592
<p>
13593
<table width="100%">
13594
<tr>
13595
<td align="left"><b>graph-toggle-or-move</b><i> </i>(<i></i>)<i>
13596
</i></td>
13597
<td align="right">Action</td>
13598
</tr>
13599
</table>
13600
<table width="95%" align="center">
13601
<tr><td>
13602
Equivalent to <code>toggle-or-move</code>, but also updates the current argument.
13603
</td></tr>
13604
</table>
13605
13606
<p>
13607
<table width="100%">
13608
<tr>
13609
<td align="left"><b>graph-popup-menu</b><i> </i>(<i></i>[<i></i><code>graph</code><i>|</i><code>node</code><i>|</i><code>shortcut</code><i></i>]<i></i>)<i>
13610
</i></td>
13611
<td align="right">Action</td>
13612
</tr>
13613
</table>
13614
<table width="95%" align="center">
13615
<tr><td>
13616
Pops up a menu. <code>graph</code> pops up a menu with global graph
11808
</p></blockquote></div>
11809
11810
<div class="defun">
11811
— Action: <b>graph-select</b> ()<var><a name="index-graph_002dselect-1263"></a></var><br>
11812
<blockquote><p>Equivalent to <code>select</code>, but also updates the current argument.
11813
</p></blockquote></div>
11814
11815
<div class="defun">
11816
— Action: <b>graph-select-or-move</b> ()<var><a name="index-graph_002dselect_002dor_002dmove-1264"></a></var><br>
11817
<blockquote><p>Equivalent to <code>select-or-move</code>, but also updates the current argument.
11818
</p></blockquote></div>
11819
11820
<div class="defun">
11821
— Action: <b>graph-extend</b> ()<var><a name="index-graph_002dextend-1265"></a></var><br>
11822
<blockquote><p>Equivalent to <code>extend</code>, but also updates the current argument.
11823
</p></blockquote></div>
11824
11825
<div class="defun">
11826
— Action: <b>graph-extend-or-move</b> ()<var><a name="index-graph_002dextend_002dor_002dmove-1266"></a></var><br>
11827
<blockquote><p>Equivalent to <code>extend-or-move</code>, but also updates the current argument.
11828
</p></blockquote></div>
11829
11830
<div class="defun">
11831
— Action: <b>graph-toggle</b> ()<var><a name="index-graph_002dtoggle-1267"></a></var><br>
11832
<blockquote><p>Equivalent to <code>toggle</code>, but also updates the current argument.
11833
</p></blockquote></div>
11834
11835
<div class="defun">
11836
— Action: <b>graph-toggle-or-move</b> ()<var><a name="index-graph_002dtoggle_002dor_002dmove-1268"></a></var><br>
11837
<blockquote><p>Equivalent to <code>toggle-or-move</code>, but also updates the current argument.
11838
</p></blockquote></div>
11839
11840
<div class="defun">
11841
— Action: <b>graph-popup-menu</b> ([<code>graph</code><var>|</var><code>node</code><var>|</var><code>shortcut</code>])<var><a name="index-graph_002dpopup_002dmenu-1269"></a></var><br>
11842
<blockquote><p>Pops up a menu. <code>graph</code> pops up a menu with global graph
13617
11843
operations, <code>node</code> pops up a menu with node operations, and
13618
11844
<code>shortcut</code> pops up a menu with display shortcuts.
13619
11845
13620
<p>If no argument is given, pops up a menu depending on the context: when
11846
<p>If no argument is given, pops up a menu depending on the context: when
13621
11847
pointing on a node with the <Shift> key pressed, behaves like
13622
11848
<code>shortcut</code>; when pointing on a without the <Shift> key pressed,
13623
11849
behaves like <code>node</code>; otherwise, behaves as if <code>graph</code> was
13624
11850
given.
13625
</td></tr>
13626
</table>
13627
13628
<p>
13629
<table width="100%">
13630
<tr>
13631
<td align="left"><b>graph-dereference</b><i> </i>(<i></i>)<i>
13632
</i></td>
13633
<td align="right">Action</td>
13634
</tr>
13635
</table>
13636
<table width="95%" align="center">
13637
<tr><td>
13638
Dereference the selected display.
13639
</td></tr>
13640
</table>
13641
13642
<p>
13643
<table width="100%">
13644
<tr>
13645
<td align="left"><b>graph-detail</b><i> </i>(<i></i>)<i>
13646
</i></td>
13647
<td align="right">Action</td>
13648
</tr>
13649
</table>
13650
<table width="95%" align="center">
13651
<tr><td>
13652
Show or hide detail of the selected display.
13653
</td></tr>
13654
</table>
13655
13656
<p>
13657
<table width="100%">
13658
<tr>
13659
<td align="left"><b>graph-rotate</b><i> </i>(<i></i>)<i>
13660
</i></td>
13661
<td align="right">Action</td>
13662
</tr>
13663
</table>
13664
<table width="95%" align="center">
13665
<tr><td>
13666
Rotate the selected display.
13667
</td></tr>
13668
</table>
13669
13670
<p>
13671
<table width="100%">
13672
<tr>
13673
<td align="left"><b>graph-dependent</b><i> </i>(<i></i>)<i>
13674
</i></td>
13675
<td align="right">Action</td>
13676
</tr>
13677
</table>
13678
<table width="95%" align="center">
13679
<tr><td>
13680
Pop up a dialog to create a dependent display.
13681
</td></tr>
13682
</table>
13683
13684
<p>
13685
<table width="100%">
13686
<tr>
13687
<td align="left"><b>hide-edges</b><i> </i>(<i></i>[<i></i><code>any</code><i>|</i><code>both</code><i>|</i><code>from</code><i>|</i><code>to</code><i></i>]<i></i>)<i>
13688
</i></td>
13689
<td align="right">Action</td>
13690
</tr>
13691
</table>
13692
<table width="95%" align="center">
13693
<tr><td>
13694
Hide some edges. <code>any</code> means to process all edges where either
11851
</p></blockquote></div>
11852
11853
<div class="defun">
11854
— Action: <b>graph-dereference</b> ()<var><a name="index-graph_002ddereference-1270"></a></var><br>
11855
<blockquote><p>Dereference the selected display.
11856
</p></blockquote></div>
11857
11858
<div class="defun">
11859
— Action: <b>graph-detail</b> ()<var><a name="index-graph_002ddetail-1271"></a></var><br>
11860
<blockquote><p>Show or hide detail of the selected display.
11861
</p></blockquote></div>
11862
11863
<div class="defun">
11864
— Action: <b>graph-rotate</b> ()<var><a name="index-graph_002drotate-1272"></a></var><br>
11865
<blockquote><p>Rotate the selected display.
11866
</p></blockquote></div>
11867
11868
<div class="defun">
11869
— Action: <b>graph-dependent</b> ()<var><a name="index-graph_002ddependent-1273"></a></var><br>
11870
<blockquote><p>Pop up a dialog to create a dependent display.
11871
</p></blockquote></div>
11872
11873
<div class="defun">
11874
— Action: <b>hide-edges</b> ([<code>any</code><var>|</var><code>both</code><var>|</var><code>from</code><var>|</var><code>to</code>])<var><a name="index-hide_002dedges-1274"></a></var><br>
11875
<blockquote><p>Hide some edges. <code>any</code> means to process all edges where either
13695
11876
source or target node are selected. <code>both</code> means to process all
13696
11877
edges where both nodes are selected. <code>from</code> means to process all
13697
11878
edges where at least the source node is selected. <code>to</code> means to
13698
11879
process all edges where at least the target node is selected. Default
13699
11880
is <code>any</code>.
13700
</td></tr>
13701
</table>
11881
</p></blockquote></div>
13702
11882
13703
<p>
13704
<table width="100%">
13705
<tr>
13706
<td align="left"><b>layout</b><i> </i>(<i></i>[<i></i><code>regular</code><i>|</i><code>compact</code><i></i>]<i>, </i>[<i></i>[<i></i><code>+</code><i>|</i><code>-</code><i></i>]<i> degrees</i>]<i></i>)<i>
13707
</i></td>
13708
<td align="right">Action</td>
13709
</tr>
13710
</table>
13711
<table width="95%" align="center">
13712
<tr><td>
13713
Layout the graph. <code>regular</code> means to use the regular layout
11883
<div class="defun">
11884
— Action: <b>layout</b> ([<code>regular</code><var>|</var><code>compact</code>]<var>, </var>[[<code>+</code><var>|</var><code>-</code>]<var> degrees</var>])<var><a name="index-layout-1275"></a></var><br>
11885
<blockquote><p>Layout the graph. <code>regular</code> means to use the regular layout
13714
11886
algorithm; <code>compact</code> uses an alternate layout algorithm, where
13715
11887
successors are placed next to their parents. Default is
13716
11888
<code>regular</code>. <var>degrees</var> indicates in which direction the graph
13717
11889
should be layouted. Default is the current graph direction.
13718
</td></tr>
13719
</table>
11890
</p></blockquote></div>
13720
11891
13721
<p>
13722
<table width="100%">
13723
<tr>
13724
<td align="left"><b>move-selected</b><i> </i>(<i>x-offset, y-offset</i>)<i>
13725
</i></td>
13726
<td align="right">Action</td>
13727
</tr>
13728
</table>
13729
<table width="95%" align="center">
13730
<tr><td>
13731
Move all selected nodes in the direction given by <var>x-offset</var> and
11892
<div class="defun">
11893
— Action: <b>move-selected</b> (<var>x-offset, y-offset</var>)<var><a name="index-move_002dselected-1276"></a></var><br>
11894
<blockquote><p>Move all selected nodes in the direction given by <var>x-offset</var> and
13732
11895
<var>y-offset</var>. <var>x-offset</var> and <var>y-offset</var> is either given as a
13733
numeric pixel value, or as <code>+grid</code>, or <code>-grid</code>, meaning the
11896
numeric pixel value, or as ‘<samp><span class="samp">+grid</span></samp>’, or <samp><span class="option">-grid</span></samp>, meaning the
13734
11897
current grid size.
13735
</td></tr>
13736
</table>
13737
13738
<p>
13739
<table width="100%">
13740
<tr>
13741
<td align="left"><b>normalize</b><i> </i>(<i></i>)<i>
13742
</i></td>
13743
<td align="right">Action</td>
13744
</tr>
13745
</table>
13746
<table width="95%" align="center">
13747
<tr><td>
13748
Place all nodes on their positions and redraw the graph.
13749
</td></tr>
13750
</table>
13751
13752
<p>
13753
<table width="100%">
13754
<tr>
13755
<td align="left"><b>rotate</b><i> </i>(<i></i>[<i></i>[<i></i><code>+</code><i>|</i><code>-</code><i></i>]<i>degrees</i>]<i></i>)<i>
13756
</i></td>
13757
<td align="right">Action</td>
13758
</tr>
13759
</table>
13760
<table width="95%" align="center">
13761
<tr><td>
13762
Rotate the graph around <var>degrees</var> degrees.
11898
</p></blockquote></div>
11899
11900
<div class="defun">
11901
— Action: <b>normalize</b> ()<var><a name="index-normalize-1277"></a></var><br>
11902
<blockquote><p>Place all nodes on their positions and redraw the graph.
11903
</p></blockquote></div>
11904
11905
<div class="defun">
11906
— Action: <b>rotate</b> ([[<code>+</code><var>|</var><code>-</code>]<var>degrees</var>])<var><a name="index-rotate-1278"></a></var><br>
11907
<blockquote><p>Rotate the graph around <var>degrees</var> degrees.
13763
11908
<var>degrees</var> must be a multiple of 90. Default is <code>+90</code>.
13764
</td></tr>
13765
</table>
11909
</p></blockquote></div>
13766
11910
13767
<p>
13768
<table width="100%">
13769
<tr>
13770
<td align="left"><b>select</b><i> </i>(<i></i>)<i>
13771
</i></td>
13772
<td align="right">Action</td>
13773
</tr>
13774
</table>
13775
<table width="95%" align="center">
13776
<tr><td>
13777
Select the node pointed at. Clear all other selections. Bound to a
11911
<div class="defun">
11912
— Action: <b>select</b> ()<var><a name="index-select-1279"></a></var><br>
11913
<blockquote><p>Select the node pointed at. Clear all other selections. Bound to a
13778
11914
button down event.
13779
</td></tr>
13780
</table>
13781
13782
<p>
13783
<table width="100%">
13784
<tr>
13785
<td align="left"><b>select-all</b><i> </i>(<i></i>)<i>
13786
</i></td>
13787
<td align="right">Action</td>
13788
</tr>
13789
</table>
13790
<table width="95%" align="center">
13791
<tr><td>
13792
Select all nodes in the graph.
13793
</td></tr>
13794
</table>
13795
13796
<p>
13797
<table width="100%">
13798
<tr>
13799
<td align="left"><b>select-first</b><i> </i>(<i></i>)<i>
13800
</i></td>
13801
<td align="right">Action</td>
13802
</tr>
13803
</table>
13804
<table width="95%" align="center">
13805
<tr><td>
13806
Select the first node in the graph.
13807
</td></tr>
13808
</table>
13809
13810
<p>
13811
<table width="100%">
13812
<tr>
13813
<td align="left"><b>select-next</b><i> </i>(<i></i>)<i>
13814
</i></td>
13815
<td align="right">Action</td>
13816
</tr>
13817
</table>
13818
<table width="95%" align="center">
13819
<tr><td>
13820
Select the next node in the graph.
13821
</td></tr>
13822
</table>
13823
13824
<p>
13825
<table width="100%">
13826
<tr>
13827
<td align="left"><b>select-or-move</b><i> </i>(<i></i>)<i>
13828
</i></td>
13829
<td align="right">Action</td>
13830
</tr>
13831
</table>
13832
<table width="95%" align="center">
13833
<tr><td>
13834
Select the node pointed at. Clear all other selections. Bound to a
11915
</p></blockquote></div>
11916
11917
<div class="defun">
11918
— Action: <b>select-all</b> ()<var><a name="index-select_002dall-1280"></a></var><br>
11919
<blockquote><p>Select all nodes in the graph.
11920
</p></blockquote></div>
11921
11922
<div class="defun">
11923
— Action: <b>select-first</b> ()<var><a name="index-select_002dfirst-1281"></a></var><br>
11924
<blockquote><p>Select the first node in the graph.
11925
</p></blockquote></div>
11926
11927
<div class="defun">
11928
— Action: <b>select-next</b> ()<var><a name="index-select_002dnext-1282"></a></var><br>
11929
<blockquote><p>Select the next node in the graph.
11930
</p></blockquote></div>
11931
11932
<div class="defun">
11933
— Action: <b>select-or-move</b> ()<var><a name="index-select_002dor_002dmove-1283"></a></var><br>
11934
<blockquote><p>Select the node pointed at. Clear all other selections. Bound to a
13835
11935
button down event. If the pointer is dragged, move the selected node.
13836
</td></tr>
13837
</table>
13838
13839
<p>
13840
<table width="100%">
13841
<tr>
13842
<td align="left"><b>select-prev</b><i> </i>(<i></i>)<i>
13843
</i></td>
13844
<td align="right">Action</td>
13845
</tr>
13846
</table>
13847
<table width="95%" align="center">
13848
<tr><td>
13849
Select the previous node in the graph.
13850
</td></tr>
13851
</table>
13852
13853
<p>
13854
<table width="100%">
13855
<tr>
13856
<td align="left"><b>show-edges</b><i> </i>(<i></i>[<i></i><code>any</code><i>|</i><code>both</code><i>|</i><code>from</code><i>|</i><code>to</code><i></i>]<i></i>)<i>
13857
</i></td>
13858
<td align="right">Action</td>
13859
</tr>
13860
</table>
13861
<table width="95%" align="center">
13862
<tr><td>
13863
Show some edges. <code>any</code> means to process all edges where either
11936
</p></blockquote></div>
11937
11938
<div class="defun">
11939
— Action: <b>select-prev</b> ()<var><a name="index-select_002dprev-1284"></a></var><br>
11940
<blockquote><p>Select the previous node in the graph.
11941
</p></blockquote></div>
11942
11943
<div class="defun">
11944
— Action: <b>show-edges</b> ([<code>any</code><var>|</var><code>both</code><var>|</var><code>from</code><var>|</var><code>to</code>])<var><a name="index-show_002dedges-1285"></a></var><br>
11945
<blockquote><p>Show some edges. <code>any</code> means to process all edges where either
13864
11946
source or target node are selected. <code>both</code> means to process all
13865
11947
edges where both nodes are selected. <code>from</code> means to process all
13866
11948
edges where at least the source node is selected. <code>to</code> means to
13867
11949
process all edges where at least the target node is selected. Default
13868
11950
is <code>any</code>.
13869
</td></tr>
13870
</table>
13871
13872
<p>
13873
<table width="100%">
13874
<tr>
13875
<td align="left"><b>snap-to-grid</b><i> </i>(<i></i>)<i>
13876
</i></td>
13877
<td align="right">Action</td>
13878
</tr>
13879
</table>
13880
<table width="95%" align="center">
13881
<tr><td>
13882
Place all nodes on the nearest grid position.
13883
</td></tr>
13884
</table>
13885
13886
<p>
13887
<table width="100%">
13888
<tr>
13889
<td align="left"><b>toggle</b><i> </i>(<i></i>)<i>
13890
</i></td>
13891
<td align="right">Action</td>
13892
</tr>
13893
</table>
13894
<table width="95%" align="center">
13895
<tr><td>
13896
Toggle the current selection--if the node pointed at is selected,
11951
</p></blockquote></div>
11952
11953
<div class="defun">
11954
— Action: <b>snap-to-grid</b> ()<var><a name="index-snap_002dto_002dgrid-1286"></a></var><br>
11955
<blockquote><p>Place all nodes on the nearest grid position.
11956
</p></blockquote></div>
11957
11958
<div class="defun">
11959
— Action: <b>toggle</b> ()<var><a name="index-toggle-1287"></a></var><br>
11960
<blockquote><p>Toggle the current selection—if the node pointed at is selected,
13897
11961
it will be unselected, and vice versa. Bound to a button down event.
13898
</td></tr>
13899
</table>
11962
</p></blockquote></div>
13900
11963
13901
<p>
13902
<table width="100%">
13903
<tr>
13904
<td align="left"><b>toggle-or-move</b><i> </i>(<i></i>)<i>
13905
</i></td>
13906
<td align="right">Action</td>
13907
</tr>
13908
</table>
13909
<table width="95%" align="center">
13910
<tr><td>
13911
Toggle the current selection--if the node pointed at is selected,
11964
<div class="defun">
11965
— Action: <b>toggle-or-move</b> ()<var><a name="index-toggle_002dor_002dmove-1288"></a></var><br>
11966
<blockquote><p>Toggle the current selection—if the node pointed at is selected,
13912
11967
it will be unselected, and vice versa. Bound to a button down event.
13913
11968
If the pointer is dragged, move the selection.
13914
</td></tr>
13915
</table>
11969
</p></blockquote></div>
13916
11970
13917
<p>
13918
<table width="100%">
13919
<tr>
13920
<td align="left"><b>unselect-all</b><i> </i>(<i></i>)<i>
13921
</i></td>
13922
<td align="right">Action</td>
13923
</tr>
13924
</table>
13925
<table width="95%" align="center">
13926
<tr><td>
13927
Clear the selection.
13928
</td></tr>
13929
</table>
11971
<div class="defun">
11972
— Action: <b>unselect-all</b> ()<var><a name="index-unselect_002dall-1289"></a></var><br>
11973
<blockquote><p>Clear the selection.
11974
</p></blockquote></div>
13930
11975
13931
11976
<div class="node">
13932
11977
<p><hr>
13933
<small class=header>
13934
Node:<a name="Debugger%20Console%20Actions">Debugger Console Actions</a>,
13935
Next:<a rel="next" accesskey="n" href="#Source%20Window%20Actions">Source Window Actions</a>,
13936
Previous:<a rel="previous" accesskey="p" href="#Data%20Display%20Actions">Data Display Actions</a>,
13937
Up:<a rel="up" accesskey="u" href="#Actions">Actions</a>
11978
<a name="Debugger-Console-Actions"></a>
11979
Next: <a rel="next" accesskey="n" href="#Source-Window-Actions">Source Window Actions</a>,
11980
Previous: <a rel="previous" accesskey="p" href="#Data-Display-Actions">Data Display Actions</a>,
11981
Up: <a rel="up" accesskey="u" href="#Actions">Actions</a>
13938
11982
</small>
13939
11983
13940
<br>
11984
13941
11985
</div>
13942
11986
13943
<h4 class="subsection">Debugger Console Actions</h4>
13944
13945
<p>These actions are used in the debugger console and other text fields.
13946
13947
<p>
13948
<table width="100%">
13949
<tr>
13950
<td align="left"><b>gdb-backward-character</b><i> </i>(<i></i>)<i>
13951
</i></td>
13952
<td align="right">Action</td>
13953
</tr>
13954
</table>
13955
<table width="95%" align="center">
13956
<tr><td>
13957
Move one character to the left. Bound to <code>Left</code>.
13958
</td></tr>
13959
</table>
13960
13961
<p>
13962
<table width="100%">
13963
<tr>
13964
<td align="left"><b>gdb-beginning-of-line</b><i> </i>(<i></i>)<i>
13965
</i></td>
13966
<td align="right">Action</td>
13967
</tr>
13968
</table>
13969
<table width="95%" align="center">
13970
<tr><td>
13971
Move cursor to the beginning of the current line, after the prompt.
11987
<h4 class="subsection">A.1.3 Debugger Console Actions</h4>
11988
11989
<p>These actions are used in the debugger console and other text fields.
11990
11991
<div class="defun">
11992
— Action: <b>gdb-backward-character</b> ()<var><a name="index-gdb_002dbackward_002dcharacter-1290"></a></var><br>
11993
<blockquote><p>Move one character to the left. Bound to <code>Left</code>.
11994
</p></blockquote></div>
11995
11996
<div class="defun">
11997
— Action: <b>gdb-beginning-of-line</b> ()<var><a name="index-gdb_002dbeginning_002dof_002dline-1291"></a></var><br>
11998
<blockquote><p>Move cursor to the beginning of the current line, after the prompt.
13972
11999
Bound to <code>HOME</code>.
13973
</td></tr>
13974
</table>
13975
13976
<p>
13977
<table width="100%">
13978
<tr>
13979
<td align="left"><b>gdb-control</b><i> </i>(<i>control-character</i>)<i>
13980
</i></td>
13981
<td align="right">Action</td>
13982
</tr>
13983
</table>
13984
<table width="95%" align="center">
13985
<tr><td>
13986
Send the given <var>control-character</var> to the inferior debugger.
13987
<var>control-character</var> must be specified in the form <code>^</code><var>X</var><code></code>,
13988
where <var>X</var> is an upper-case letter, or <code>?</code>.
13989
</td></tr>
13990
</table>
13991
13992
<p>
13993
<table width="100%">
13994
<tr>
13995
<td align="left"><b>gdb-command</b><i> </i>(<i>command</i>)<i>
13996
</i></td>
13997
<td align="right">Action</td>
13998
</tr>
13999
</table>
14000
<table width="95%" align="center">
14001
<tr><td>
14002
Execute <var>command</var> in the debugger console. The following
12000
</p></blockquote></div>
12001
12002
<div class="defun">
12003
— Action: <b>gdb-control</b> (<var>control-character</var>)<var><a name="index-gdb_002dcontrol-1292"></a></var><br>
12004
<blockquote><p>Send the given <var>control-character</var> to the inferior debugger.
12005
<var>control-character</var> must be specified in the form ‘<samp><span class="samp">^</span><var>X</var></samp>’,
12006
where <var>X</var> is an upper-case letter, or ‘<samp><span class="samp">?</span></samp>’.
12007
</p></blockquote></div>
12008
12009
<div class="defun">
12010
— Action: <b>gdb-command</b> (<var>command</var>)<var><a name="index-gdb_002dcommand-1293"></a></var><br>
12011
<blockquote><p>Execute <var>command</var> in the debugger console. The following
14003
12012
replacements are performed on <var>command</var>:
14004
12013
14005
12014
<ul>
14006
<li>If <var>command</var> has the form <code></code><var>name</var><code>...</code>, insert <var>name</var>,
12015
<li>If <var>command</var> has the form ‘<samp><var>name</var><span class="samp">...</span></samp>’, insert <var>name</var>,
14007
12016
followed by a space, in the debugger console.
14008
12017
14009
<li>All occurrences of <code>()</code> are replaced by the current contents of
14010
the argument field <code>()</code>.
14011
14012
</ul>
14013
</td></tr>
14014
</table>
14015
14016
<p>
14017
<table width="100%">
14018
<tr>
14019
<td align="left"><b>gdb-complete-arg</b><i> </i>(<i>command</i>)<i>
14020
</i></td>
14021
<td align="right">Action</td>
14022
</tr>
14023
</table>
14024
<table width="95%" align="center">
14025
<tr><td>
14026
Complete current argument as if <var>command</var> was prepended.
12018
<li>All occurrences of ‘<samp><span class="samp">()</span></samp>’ are replaced by the current contents of
12019
the argument field ‘<samp><span class="samp">()</span></samp>’.
12020
12021
</ul>
12022
</p></blockquote></div>
12023
12024
<div class="defun">
12025
— Action: <b>gdb-complete-arg</b> (<var>command</var>)<var><a name="index-gdb_002dcomplete_002darg-1294"></a></var><br>
12026
<blockquote><p>Complete current argument as if <var>command</var> was prepended.
14027
12027
Bound to <Ctrl+T>.
14028
</td></tr>
14029
</table>
12028
</p></blockquote></div>
14030
12029
14031
<p>
14032
<table width="100%">
14033
<tr>
14034
<td align="left"><b>gdb-complete-command</b><i> </i>(<i></i>)<i>
14035
</i></td>
14036
<td align="right">Action</td>
14037
</tr>
14038
</table>
14039
<table width="95%" align="center">
14040
<tr><td>
14041
Complete current command line in the debugger console.
12030
<div class="defun">
12031
— Action: <b>gdb-complete-command</b> ()<var><a name="index-gdb_002dcomplete_002dcommand-1295"></a></var><br>
12032
<blockquote><p>Complete current command line in the debugger console.
14042
12033
Bound to <TAB>.
14043
</td></tr>
14044
</table>
12034
</p></blockquote></div>
14045
12035
14046
<p>
14047
<table width="100%">
14048
<tr>
14049
<td align="left"><b>gdb-complete-tab</b><i> </i>(<i>command</i>)<i>
14050
</i></td>
14051
<td align="right">Action</td>
14052
</tr>
14053
</table>
14054
<table width="95%" align="center">
14055
<tr><td>
14056
If global <TAB> completion is enabled, complete current
12036
<div class="defun">
12037
— Action: <b>gdb-complete-tab</b> (<var>command</var>)<var><a name="index-gdb_002dcomplete_002dtab-1296"></a></var><br>
12038
<blockquote><p>If global <TAB> completion is enabled, complete current
14057
12039
argument as if <var>command</var> was prepended. Otherwise, proceed as if
14058
12040
the <TAB> key was hit. Bound to <TAB>.
14059
</td></tr>
14060
</table>
12041
</p></blockquote></div>
14061
12042
14062
<p>
14063
<table width="100%">
14064
<tr>
14065
<td align="left"><b>gdb-delete-or-control</b><i> </i>(<i>control-character</i>)<i>
14066
</i></td>
14067
<td align="right">Action</td>
14068
</tr>
14069
</table>
14070
<table width="95%" align="center">
14071
<tr><td>
14072
Like <code>gdb-control</code>, but effective only if the cursor is at the end
12043
<div class="defun">
12044
— Action: <b>gdb-delete-or-control</b> (<var>control-character</var>)<var><a name="index-gdb_002ddelete_002dor_002dcontrol-1297"></a></var><br>
12045
<blockquote><p>Like <code>gdb-control</code>, but effective only if the cursor is at the end
14073
12046
of a line. Otherwise, <var>control-character</var> is ignored and the
14074
12047
character following the cursor is deleted. Bound to <Ctrl+D>.
14075
</td></tr>
14076
</table>
14077
14078
<p>
14079
<table width="100%">
14080
<tr>
14081
<td align="left"><b>gdb-end-of-line</b><i> </i>(<i></i>)<i>
14082
</i></td>
14083
<td align="right">Action</td>
14084
</tr>
14085
</table>
14086
<table width="95%" align="center">
14087
<tr><td>
14088
Move cursor to the end of the current line. Bound to <code>End</code>.
14089
</td></tr>
14090
</table>
14091
14092
<p>
14093
<table width="100%">
14094
<tr>
14095
<td align="left"><b>gdb-forward-character</b><i> </i>(<i></i>)<i>
14096
</i></td>
14097
<td align="right">Action</td>
14098
</tr>
14099
</table>
14100
<table width="95%" align="center">
14101
<tr><td>
14102
Move one character to the right. Bound to <code>Right</code>.
14103
</td></tr>
14104
</table>
14105
14106
<p>
14107
<table width="100%">
14108
<tr>
14109
<td align="left"><b>gdb-insert-graph-arg</b><i> </i>(<i></i>)<i>
14110
</i></td>
14111
<td align="right">Action</td>
14112
</tr>
14113
</table>
14114
<table width="95%" align="center">
14115
<tr><td>
14116
Insert the contents of the data display argument field <code>()</code>.
14117
</td></tr>
14118
</table>
14119
14120
<p>
14121
<table width="100%">
14122
<tr>
14123
<td align="left"><b>gdb-insert-source-arg</b><i> </i>(<i></i>)<i>
14124
</i></td>
14125
<td align="right">Action</td>
14126
</tr>
14127
</table>
14128
<table width="95%" align="center">
14129
<tr><td>
14130
Insert the contents of the source argument field <code>()</code>.
14131
</td></tr>
14132
</table>
14133
14134
<p>
14135
<table width="100%">
14136
<tr>
14137
<td align="left"><b>gdb-interrupt</b><i> </i>(<i></i>)<i>
14138
</i></td>
14139
<td align="right">Action</td>
14140
</tr>
14141
</table>
14142
<table width="95%" align="center">
14143
<tr><td>
14144
If <small>DDD</small> is in incremental search mode, exit it; otherwise
12048
</p></blockquote></div>
12049
12050
<div class="defun">
12051
— Action: <b>gdb-end-of-line</b> ()<var><a name="index-gdb_002dend_002dof_002dline-1298"></a></var><br>
12052
<blockquote><p>Move cursor to the end of the current line. Bound to <code>End</code>.
12053
</p></blockquote></div>
12054
12055
<div class="defun">
12056
— Action: <b>gdb-forward-character</b> ()<var><a name="index-gdb_002dforward_002dcharacter-1299"></a></var><br>
12057
<blockquote><p>Move one character to the right. Bound to <code>Right</code>.
12058
</p></blockquote></div>
12059
12060
<div class="defun">
12061
— Action: <b>gdb-insert-graph-arg</b> ()<var><a name="index-gdb_002dinsert_002dgraph_002darg-1300"></a></var><br>
12062
<blockquote><p>Insert the contents of the data display argument field ‘<samp><span class="samp">()</span></samp>’.
12063
</p></blockquote></div>
12064
12065
<div class="defun">
12066
— Action: <b>gdb-insert-source-arg</b> ()<var><a name="index-gdb_002dinsert_002dsource_002darg-1301"></a></var><br>
12067
<blockquote><p>Insert the contents of the source argument field ‘<samp><span class="samp">()</span></samp>’.
12068
</p></blockquote></div>
12069
12070
<div class="defun">
12071
— Action: <b>gdb-interrupt</b> ()<var><a name="index-gdb_002dinterrupt-1302"></a></var><br>
12072
<blockquote><p>If <acronym>DDD</acronym> is in incremental search mode, exit it; otherwise
14145
12073
call <code>gdb-control(^C)</code>.
14146
</td></tr>
14147
</table>
14148
14149
<p>
14150
<table width="100%">
14151
<tr>
14152
<td align="left"><b>gdb-isearch-prev</b><i> </i>(<i></i>)<i>
14153
</i></td>
14154
<td align="right">Action</td>
14155
</tr>
14156
</table>
14157
<table width="95%" align="center">
14158
<tr><td>
14159
Enter reverse incremental search mode. Bound to <Ctrl+B>.
14160
</td></tr>
14161
</table>
14162
14163
<p>
14164
<table width="100%">
14165
<tr>
14166
<td align="left"><b>gdb-isearch-next</b><i> </i>(<i></i>)<i>
14167
</i></td>
14168
<td align="right">Action</td>
14169
</tr>
14170
</table>
14171
<table width="95%" align="center">
14172
<tr><td>
14173
Enter incremental search mode. Bound to <Ctrl+F>.
14174
</td></tr>
14175
</table>
14176
14177
<p>
14178
<table width="100%">
14179
<tr>
14180
<td align="left"><b>gdb-isearch-exit</b><i> </i>(<i></i>)<i>
14181
</i></td>
14182
<td align="right">Action</td>
14183
</tr>
14184
</table>
14185
<table width="95%" align="center">
14186
<tr><td>
14187
Exit incremental search mode. Bound to <ESC>.
14188
</td></tr>
14189
</table>
14190
14191
<p>
14192
<table width="100%">
14193
<tr>
14194
<td align="left"><b>gdb-next-history</b><i> </i>(<i></i>)<i>
14195
</i></td>
14196
<td align="right">Action</td>
14197
</tr>
14198
</table>
14199
<table width="95%" align="center">
14200
<tr><td>
14201
Recall next command from history. Bound to <code>Down</code>.
14202
</td></tr>
14203
</table>
14204
14205
<p>
14206
<table width="100%">
14207
<tr>
14208
<td align="left"><b>gdb-prev-history</b><i> </i>(<i></i>)<i>
14209
</i></td>
14210
<td align="right">Action</td>
14211
</tr>
14212
</table>
14213
<table width="95%" align="center">
14214
<tr><td>
14215
Recall previous command from history. Bound to <code>Up</code>.
14216
</td></tr>
14217
</table>
14218
14219
<p>
14220
<table width="100%">
14221
<tr>
14222
<td align="left"><b>gdb-previous-history</b><i> </i>(<i></i>)<i>
14223
</i></td>
14224
<td align="right">Action</td>
14225
</tr>
14226
</table>
14227
<table width="95%" align="center">
14228
<tr><td>
14229
Recall previous command from history. Bound to <code>Up</code>.
14230
</td></tr>
14231
</table>
14232
14233
<p>
14234
<table width="100%">
14235
<tr>
14236
<td align="left"><b>gdb-process</b><i> </i>(<i></i>[<i>action </i>[<i>, args<small class="dots">...</small></i>]<i></i>]<i></i>)<i>
14237
</i></td>
14238
<td align="right">Action</td>
14239
</tr>
14240
</table>
14241
<table width="95%" align="center">
14242
<tr><td>
14243
Process the given event in the debugger console. Bound to key events
12074
</p></blockquote></div>
12075
12076
<div class="defun">
12077
— Action: <b>gdb-isearch-prev</b> ()<var><a name="index-gdb_002disearch_002dprev-1303"></a></var><br>
12078
<blockquote><p>Enter reverse incremental search mode. Bound to <Ctrl+B>.
12079
</p></blockquote></div>
12080
12081
<div class="defun">
12082
— Action: <b>gdb-isearch-next</b> ()<var><a name="index-gdb_002disearch_002dnext-1304"></a></var><br>
12083
<blockquote><p>Enter incremental search mode. Bound to <Ctrl+F>.
12084
</p></blockquote></div>
12085
12086
<div class="defun">
12087
— Action: <b>gdb-isearch-exit</b> ()<var><a name="index-gdb_002disearch_002dexit-1305"></a></var><br>
12088
<blockquote><p>Exit incremental search mode. Bound to <ESC>.
12089
</p></blockquote></div>
12090
12091
<div class="defun">
12092
— Action: <b>gdb-next-history</b> ()<var><a name="index-gdb_002dnext_002dhistory-1306"></a></var><br>
12093
<blockquote><p>Recall next command from history. Bound to <code>Down</code>.
12094
</p></blockquote></div>
12095
12096
<div class="defun">
12097
— Action: <b>gdb-prev-history</b> ()<var><a name="index-gdb_002dprev_002dhistory-1307"></a></var><br>
12098
<blockquote><p>Recall previous command from history. Bound to <code>Up</code>.
12099
</p></blockquote></div>
12100
12101
<div class="defun">
12102
— Action: <b>gdb-previous-history</b> ()<var><a name="index-gdb_002dprevious_002dhistory-1308"></a></var><br>
12103
<blockquote><p>Recall previous command from history. Bound to <code>Up</code>.
12104
</p></blockquote></div>
12105
12106
<div class="defun">
12107
— Action: <b>gdb-process</b> ([<var>action </var>[<var>, args<small class="dots">...</small></var>]])<var><a name="index-gdb_002dprocess-1309"></a></var><br>
12108
<blockquote><p>Process the given event in the debugger console. Bound to key events
14244
12109
in the source and data window. If this action is bound to the source
14245
12110
window, and the source window is editable, perform
14246
<code></code><var>action</var><code>(</code><var>args</var><code>...)</code> on the source window instead; if
14247
<var>action</var> is not given, perform <code>self-insert()</code>.
14248
</td></tr>
14249
</table>
12111
<var>action</var><code>(</code><var>args</var><code>...)</code> on the source window instead; if
12112
<var>action</var> is not given, perform ‘<samp><span class="samp">self-insert()</span></samp>’.
12113
</p></blockquote></div>
14250
12114
14251
<p>
14252
<table width="100%">
14253
<tr>
14254
<td align="left"><b>gdb-select-all</b><i> </i>(<i></i>)<i>
14255
</i></td>
14256
<td align="right">Action</td>
14257
</tr>
14258
</table>
14259
<table width="95%" align="center">
14260
<tr><td>
14261
If the <code>selectAllBindings</code> resource is set to <code>Motif</code>,
14262
perform <code>beginning-of-line</code>. Otherwise, perform <code>select-all</code>.
12115
<div class="defun">
12116
— Action: <b>gdb-select-all</b> ()<var><a name="index-gdb_002dselect_002dall-1310"></a></var><br>
12117
<blockquote><p>If the ‘<samp><span class="samp">selectAllBindings</span></samp>’ resource is set to <code>Motif</code>,
12118
perform ‘<samp><span class="samp">beginning-of-line</span></samp>’. Otherwise, perform ‘<samp><span class="samp">select-all</span></samp>’.
14263
12119
Bound to <Ctrl+A>.
14264
</td></tr>
14265
</table>
12120
</p></blockquote></div>
14266
12121
14267
<p>
14268
<table width="100%">
14269
<tr>
14270
<td align="left"><b>gdb-set-line</b><i> </i>(<i>value</i>)<i>
14271
</i></td>
14272
<td align="right">Action</td>
14273
</tr>
14274
</table>
14275
<table width="95%" align="center">
14276
<tr><td>
14277
Set the current line to <var>value</var>. Bound to <Ctrl+U>.
14278
</td></tr>
14279
</table>
12122
<div class="defun">
12123
— Action: <b>gdb-set-line</b> (<var>value</var>)<var><a name="index-gdb_002dset_002dline-1311"></a></var><br>
12124
<blockquote><p>Set the current line to <var>value</var>. Bound to <Ctrl+U>.
12125
</p></blockquote></div>
14280
12126
14281
12127
<div class="node">
14282
12128
<p><hr>
14283
<small class=header>
14284
Node:<a name="Source%20Window%20Actions">Source Window Actions</a>,
14285
Previous:<a rel="previous" accesskey="p" href="#Debugger%20Console%20Actions">Debugger Console Actions</a>,
14286
Up:<a rel="up" accesskey="u" href="#Actions">Actions</a>
12129
<a name="Source-Window-Actions"></a>
12130
Previous: <a rel="previous" accesskey="p" href="#Debugger-Console-Actions">Debugger Console Actions</a>,
12131
Up: <a rel="up" accesskey="u" href="#Actions">Actions</a>
14287
12132
</small>
14288
12133
14289
<br>
12134
14290
12135
</div>
14291
12136
14292
<h4 class="subsection">Source Window Actions</h4>
14293
14294
<p>These actions are used in the source and code windows.
14295
14296
<p>
14297
<table width="100%">
14298
<tr>
14299
<td align="left"><b>source-delete-glyph</b><i> </i>(<i></i>)<i>
14300
</i></td>
14301
<td align="right">Action</td>
14302
</tr>
14303
</table>
14304
<table width="95%" align="center">
14305
<tr><td>
14306
Delete the breakpoint related to the glyph at cursor position.
14307
</td></tr>
14308
</table>
14309
14310
<p>
14311
<table width="100%">
14312
<tr>
14313
<td align="left"><b>source-double-click</b><i> </i>(<i></i>[<i>text-action </i>[<i>, line-action </i>[<i>, function-action</i>]<i></i>]<i></i>]<i></i>)<i>
14314
</i></td>
14315
<td align="right">Action</td>
14316
</tr>
14317
</table>
14318
<table width="95%" align="center">
14319
<tr><td>
14320
The double-click action in the source window.
12137
<h4 class="subsection">A.1.4 Source Window Actions</h4>
12138
12139
<p>These actions are used in the source and code windows.
12140
12141
<div class="defun">
12142
— Action: <b>source-delete-glyph</b> ()<var><a name="index-source_002ddelete_002dglyph-1312"></a></var><br>
12143
<blockquote><p>Delete the breakpoint related to the glyph at cursor position.
12144
</p></blockquote></div>
12145
12146
<div class="defun">
12147
— Action: <b>source-double-click</b> ([<var>text-action </var>[<var>, line-action </var>[<var>, function-action</var>]]])<var><a name="index-source_002ddouble_002dclick-1313"></a></var><br>
12148
<blockquote><p>The double-click action in the source window.
14321
12149
14322
12150
<ul>
14323
12151
<li>If this action is taken on a breakpoint glyph, edit the breakpoint
14324
12152
properties.
14325
12153
<li>If this action is taken in the breakpoint area, invoke
14326
<code>gdb-command(</code><var>line-action</var><code>)</code>. If <var>line-action</var> is not
14327
given, it defaults to <code>break ()</code>.
12154
‘<samp><span class="samp">gdb-command(</span><var>line-action</var><span class="samp">)</span></samp>’. If <var>line-action</var> is not
12155
given, it defaults to ‘<samp><span class="samp">break ()</span></samp>’.
14328
12156
<li>If this action is taken in the source text, and the next character
14329
following the current selection is <code>(</code>, invoke
14330
<code>gdb-command(</code><var>function-action</var><code>)</code>. If <var>function-action</var>
14331
is not given, it defaults to <code>list ()</code>.
14332
<li>Otherwise, invoke <code>gdb-command(</code><var>text-action</var><code>)</code>. If
14333
<var>text-action</var> is not given, it defaults to <code>graph display ()</code>.
12157
following the current selection is ‘<samp><span class="samp">(</span></samp>’, invoke
12158
‘<samp><span class="samp">gdb-command(</span><var>function-action</var><span class="samp">)</span></samp>’. If <var>function-action</var>
12159
is not given, it defaults to ‘<samp><span class="samp">list ()</span></samp>’.
12160
<li>Otherwise, invoke ‘<samp><span class="samp">gdb-command(</span><var>text-action</var><span class="samp">)</span></samp>’. If
12161
<var>text-action</var> is not given, it defaults to ‘<samp><span class="samp">graph display ()</span></samp>’.
14334
12162
</ul>
14335
</td></tr>
14336
</table>
14337
14338
<p>
14339
<table width="100%">
14340
<tr>
14341
<td align="left"><b>source-drag-glyph</b><i> </i>(<i></i>)<i>
14342
</i></td>
14343
<td align="right">Action</td>
14344
</tr>
14345
</table>
14346
<table width="95%" align="center">
14347
<tr><td>
14348
Initiate a drag on the glyph at cursor position.
14349
</td></tr>
14350
</table>
14351
14352
<p>
14353
<table width="100%">
14354
<tr>
14355
<td align="left"><b>source-drop-glyph</b><i> </i>(<i></i>[<i>action</i>]<i></i>)<i>
14356
</i></td>
14357
<td align="right">Action</td>
14358
</tr>
14359
</table>
14360
<table width="95%" align="center">
14361
<tr><td>
14362
Drop the dragged glyph at cursor position. <var>action</var> is either
14363
<code>move</code>, meaning to move the dragged glyph, or <code>copy</code>,
12163
</p></blockquote></div>
12164
12165
<div class="defun">
12166
— Action: <b>source-drag-glyph</b> ()<var><a name="index-source_002ddrag_002dglyph-1314"></a></var><br>
12167
<blockquote><p>Initiate a drag on the glyph at cursor position.
12168
</p></blockquote></div>
12169
12170
<div class="defun">
12171
— Action: <b>source-drop-glyph</b> ([<var>action</var>])<var><a name="index-source_002ddrop_002dglyph-1315"></a></var><br>
12172
<blockquote><p>Drop the dragged glyph at cursor position. <var>action</var> is either
12173
‘<samp><span class="samp">move</span></samp>’, meaning to move the dragged glyph, or ‘<samp><span class="samp">copy</span></samp>’,
14364
12174
meaning to copy the dragged glyph. If no <var>action</var> is given,
14365
<code>move</code> is assumed.
14366
</td></tr>
14367
</table>
14368
14369
<p>
14370
<table width="100%">
14371
<tr>
14372
<td align="left"><b>source-end-select-word</b><i> </i>(<i></i>)<i>
14373
</i></td>
14374
<td align="right">Action</td>
14375
</tr>
14376
</table>
14377
<table width="95%" align="center">
14378
<tr><td>
14379
End selecting a word.
14380
</td></tr>
14381
</table>
14382
14383
<p>
14384
<table width="100%">
14385
<tr>
14386
<td align="left"><b>source-follow-glyph</b><i> </i>(<i></i>)<i>
14387
</i></td>
14388
<td align="right">Action</td>
14389
</tr>
14390
</table>
14391
<table width="95%" align="center">
14392
<tr><td>
14393
Continue a drag on the glyph at cursor position. Usually bound to
12175
‘<samp><span class="samp">move</span></samp>’ is assumed.
12176
</p></blockquote></div>
12177
12178
<div class="defun">
12179
— Action: <b>source-end-select-word</b> ()<var><a name="index-source_002dend_002dselect_002dword-1316"></a></var><br>
12180
<blockquote><p>End selecting a word.
12181
</p></blockquote></div>
12182
12183
<div class="defun">
12184
— Action: <b>source-follow-glyph</b> ()<var><a name="index-source_002dfollow_002dglyph-1317"></a></var><br>
12185
<blockquote><p>Continue a drag on the glyph at cursor position. Usually bound to
14394
12186
some motion event.
14395
</td></tr>
14396
</table>
14397
14398
<p>
14399
<table width="100%">
14400
<tr>
14401
<td align="left"><b>source-popup-menu</b><i> </i>(<i></i>)<i>
14402
</i></td>
14403
<td align="right">Action</td>
14404
</tr>
14405
</table>
14406
<table width="95%" align="center">
14407
<tr><td>
14408
Pop up a menu, depending on the location.
14409
</td></tr>
14410
</table>
14411
14412
<p>
14413
<table width="100%">
14414
<tr>
14415
<td align="left"><b>source-set-arg</b><i> </i>(<i></i>)<i>
14416
</i></td>
14417
<td align="right">Action</td>
14418
</tr>
14419
</table>
14420
<table width="95%" align="center">
14421
<tr><td>
14422
Set the argument field to the current selection. Typically bound to
12187
</p></blockquote></div>
12188
12189
<div class="defun">
12190
— Action: <b>source-popup-menu</b> ()<var><a name="index-source_002dpopup_002dmenu-1318"></a></var><br>
12191
<blockquote><p>Pop up a menu, depending on the location.
12192
</p></blockquote></div>
12193
12194
<div class="defun">
12195
— Action: <b>source-set-arg</b> ()<var><a name="index-source_002dset_002darg-1319"></a></var><br>
12196
<blockquote><p>Set the argument field to the current selection. Typically bound to
14423
12197
some selection operation.
14424
</td></tr>
14425
</table>
14426
14427
<p>
14428
<table width="100%">
14429
<tr>
14430
<td align="left"><b>source-start-select-word</b><i> </i>(<i></i>)<i>
14431
</i></td>
14432
<td align="right">Action</td>
14433
</tr>
14434
</table>
14435
<table width="95%" align="center">
14436
<tr><td>
14437
Start selecting a word.
14438
</td></tr>
14439
</table>
14440
14441
<p>
14442
<table width="100%">
14443
<tr>
14444
<td align="left"><b>source-update-glyphs</b><i> </i>(<i></i>)<i>
14445
</i></td>
14446
<td align="right">Action</td>
14447
</tr>
14448
</table>
14449
<table width="95%" align="center">
14450
<tr><td>
14451
Update all visible glyphs. Usually invoked after a scrolling operation.
14452
</td></tr>
14453
</table>
12198
</p></blockquote></div>
12199
12200
<div class="defun">
12201
— Action: <b>source-start-select-word</b> ()<var><a name="index-source_002dstart_002dselect_002dword-1320"></a></var><br>
12202
<blockquote><p>Start selecting a word.
12203
</p></blockquote></div>
12204
12205
<div class="defun">
12206
— Action: <b>source-update-glyphs</b> ()<var><a name="index-source_002dupdate_002dglyphs-1321"></a></var><br>
12207
<blockquote><p>Update all visible glyphs. Usually invoked after a scrolling operation.
12208
</p></blockquote></div>
14454
12209
14455
12210
<div class="node">
14456
12211
<p><hr>
14457
<small class=header>
14458
Node:<a name="Images">Images</a>,
14459
Previous:<a rel="previous" accesskey="p" href="#Actions">Actions</a>,
14460
Up:<a rel="up" accesskey="u" href="#Application%20Defaults">Application Defaults</a>
12212
<a name="Images"></a>
12213
Previous: <a rel="previous" accesskey="p" href="#Actions">Actions</a>,
12214
Up: <a rel="up" accesskey="u" href="#Application-Defaults">Application Defaults</a>
14461
12215
</small>
14462
12216
14463
<br>
12217
14464
12218
</div>
14465
12219
14466
<h3 class="section">Images</h3>
12220
<h3 class="section">A.2 Images</h3>
14467
12221
14468
<p><small>DDD</small> installs a number of images that may be used as pixmap
12222
<p><acronym>DDD</acronym> installs a number of images that may be used as pixmap
14469
12223
resources, simply by giving a symbolic name. For button images,
14470
12224
three variants are installed as well:
14471
12225
14472
12226
<ul>
14473
<li>The suffix <code>-hi</code> indicates a highlighted variant (Button is entered).
14474
<li>The suffix <code>-arm</code> indicates an armed variant (Button is pushed).
14475
<li>The suffix <code>-xx</code> indicates a disabled (insensitive) variant.
12227
<li>The suffix <samp><span class="option">-hi</span></samp> indicates a highlighted variant (Button is entered).
12228
<li>The suffix <samp><span class="option">-arm</span></samp> indicates an armed variant (Button is pushed).
12229
<li>The suffix <samp><span class="option">-xx</span></samp> indicates a disabled (insensitive) variant.
14476
12230
</ul>
14477
12231
14478
<p>
14479
<table width="100%">
14480
<tr>
14481
<td align="left"><b>break_at</b><i>
14482
</i></td>
14483
<td align="right">Image</td>
14484
</tr>
14485
</table>
14486
<table width="95%" align="center">
14487
<tr><td>
14488
<code>Break at ()</code> button.
14489
</td></tr>
14490
</table>
14491
14492
<p>
14493
<table width="100%">
14494
<tr>
14495
<td align="left"><b>clear_at</b><i>
14496
</i></td>
14497
<td align="right">Image</td>
14498
</tr>
14499
</table>
14500
<table width="95%" align="center">
14501
<tr><td>
14502
<code>Clear at ()</code> button.
14503
</td></tr>
14504
</table>
14505
14506
<p>
14507
<table width="100%">
14508
<tr>
14509
<td align="left"><b>ddd</b><i>
14510
</i></td>
14511
<td align="right">Image</td>
14512
</tr>
14513
</table>
14514
<table width="95%" align="center">
14515
<tr><td>
14516
<small>DDD</small> icon.
14517
</td></tr>
14518
</table>
14519
14520
<p>
14521
<table width="100%">
14522
<tr>
14523
<td align="left"><b>delete</b><i>
14524
</i></td>
14525
<td align="right">Image</td>
14526
</tr>
14527
</table>
14528
<table width="95%" align="center">
14529
<tr><td>
14530
<code>Delete ()</code> button.
14531
</td></tr>
14532
</table>
14533
14534
<p>
14535
<table width="100%">
14536
<tr>
14537
<td align="left"><b>disable</b><i>
14538
</i></td>
14539
<td align="right">Image</td>
14540
</tr>
14541
</table>
14542
<table width="95%" align="center">
14543
<tr><td>
14544
<code>Disable</code> button.
14545
</td></tr>
14546
</table>
14547
14548
<p>
14549
<table width="100%">
14550
<tr>
14551
<td align="left"><b>dispref</b><i>
14552
</i></td>
14553
<td align="right">Image</td>
14554
</tr>
14555
</table>
14556
<table width="95%" align="center">
14557
<tr><td>
14558
<code>Display * ()</code> button.
14559
</td></tr>
14560
</table>
14561
14562
<p>
14563
<table width="100%">
14564
<tr>
14565
<td align="left"><b>display</b><i>
14566
</i></td>
14567
<td align="right">Image</td>
14568
</tr>
14569
</table>
14570
<table width="95%" align="center">
14571
<tr><td>
14572
<code>Display ()</code> button.
14573
</td></tr>
14574
</table>
14575
14576
<p>
14577
<table width="100%">
14578
<tr>
14579
<td align="left"><b>drag_arrow</b><i>
14580
</i></td>
14581
<td align="right">Image</td>
14582
</tr>
14583
</table>
14584
<table width="95%" align="center">
14585
<tr><td>
14586
The execution pointer (being dragged).
14587
</td></tr>
14588
</table>
14589
14590
<p>
14591
<table width="100%">
14592
<tr>
14593
<td align="left"><b>drag_cond</b><i>
14594
</i></td>
14595
<td align="right">Image</td>
14596
</tr>
14597
</table>
14598
<table width="95%" align="center">
14599
<tr><td>
14600
A conditional breakpoint (being dragged).
14601
</td></tr>
14602
</table>
14603
14604
<p>
14605
<table width="100%">
14606
<tr>
14607
<td align="left"><b>drag_stop</b><i>
14608
</i></td>
14609
<td align="right">Image</td>
14610
</tr>
14611
</table>
14612
<table width="95%" align="center">
14613
<tr><td>
14614
A breakpoint (being dragged).
14615
</td></tr>
14616
</table>
14617
14618
<p>
14619
<table width="100%">
14620
<tr>
14621
<td align="left"><b>drag_temp</b><i>
14622
</i></td>
14623
<td align="right">Image</td>
14624
</tr>
14625
</table>
14626
<table width="95%" align="center">
14627
<tr><td>
14628
A temporary breakpoint (being dragged).
14629
</td></tr>
14630
</table>
14631
14632
<p>
14633
<table width="100%">
14634
<tr>
14635
<td align="left"><b>enable</b><i>
14636
</i></td>
14637
<td align="right">Image</td>
14638
</tr>
14639
</table>
14640
<table width="95%" align="center">
14641
<tr><td>
14642
<code>Enable</code> button.
14643
</td></tr>
14644
</table>
14645
14646
<p>
14647
<table width="100%">
14648
<tr>
14649
<td align="left"><b>find_forward</b><i>
14650
</i></td>
14651
<td align="right">Image</td>
14652
</tr>
14653
</table>
14654
<table width="95%" align="center">
14655
<tr><td>
14656
<code>Find>> ()</code> button.
14657
</td></tr>
14658
</table>
14659
14660
<p>
14661
<table width="100%">
14662
<tr>
14663
<td align="left"><b>find_backward</b><i>
14664
</i></td>
14665
<td align="right">Image</td>
14666
</tr>
14667
</table>
14668
<table width="95%" align="center">
14669
<tr><td>
14670
<code>Find<< ()</code> button.
14671
</td></tr>
14672
</table>
14673
14674
<p>
14675
<table width="100%">
14676
<tr>
14677
<td align="left"><b>grey_arrow</b><i>
14678
</i></td>
14679
<td align="right">Image</td>
14680
</tr>
14681
</table>
14682
<table width="95%" align="center">
14683
<tr><td>
14684
The execution pointer (not in lowest frame).
14685
</td></tr>
14686
</table>
14687
14688
<p>
14689
<table width="100%">
14690
<tr>
14691
<td align="left"><b>grey_cond</b><i>
14692
</i></td>
14693
<td align="right">Image</td>
14694
</tr>
14695
</table>
14696
<table width="95%" align="center">
14697
<tr><td>
14698
A conditional breakpoint (disabled).
14699
</td></tr>
14700
</table>
14701
14702
<p>
14703
<table width="100%">
14704
<tr>
14705
<td align="left"><b>grey_stop</b><i>
14706
</i></td>
14707
<td align="right">Image</td>
14708
</tr>
14709
</table>
14710
<table width="95%" align="center">
14711
<tr><td>
14712
A breakpoint (disabled).
14713
</td></tr>
14714
</table>
14715
14716
<p>
14717
<table width="100%">
14718
<tr>
14719
<td align="left"><b>grey_temp</b><i>
14720
</i></td>
14721
<td align="right">Image</td>
14722
</tr>
14723
</table>
14724
<table width="95%" align="center">
14725
<tr><td>
14726
A temporary breakpoint (disabled).
14727
</td></tr>
14728
</table>
14729
14730
<p>
14731
<table width="100%">
14732
<tr>
14733
<td align="left"><b>hide</b><i>
14734
</i></td>
14735
<td align="right">Image</td>
14736
</tr>
14737
</table>
14738
<table width="95%" align="center">
14739
<tr><td>
14740
<code>Hide ()</code> button.
14741
</td></tr>
14742
</table>
14743
14744
<p>
14745
<table width="100%">
14746
<tr>
14747
<td align="left"><b>lookup</b><i>
14748
</i></td>
14749
<td align="right">Image</td>
14750
</tr>
14751
</table>
14752
<table width="95%" align="center">
14753
<tr><td>
14754
<code>Lookup ()</code> button.
14755
</td></tr>
14756
</table>
14757
14758
<p>
14759
<table width="100%">
14760
<tr>
14761
<td align="left"><b>maketemp</b><i>
14762
</i></td>
14763
<td align="right">Image</td>
14764
</tr>
14765
</table>
14766
<table width="95%" align="center">
14767
<tr><td>
14768
<code>Make Temporary</code> button.
14769
</td></tr>
14770
</table>
14771
14772
<p>
14773
<table width="100%">
14774
<tr>
14775
<td align="left"><b>new_break</b><i>
14776
</i></td>
14777
<td align="right">Image</td>
14778
</tr>
14779
</table>
14780
<table width="95%" align="center">
14781
<tr><td>
14782
<code>New Breakpoint</code> button.
14783
</td></tr>
14784
</table>
14785
14786
<p>
14787
<table width="100%">
14788
<tr>
14789
<td align="left"><b>new_display</b><i>
14790
</i></td>
14791
<td align="right">Image</td>
14792
</tr>
14793
</table>
14794
<table width="95%" align="center">
14795
<tr><td>
14796
<code>New Display</code> button.
14797
</td></tr>
14798
</table>
14799
14800
<p>
14801
<table width="100%">
14802
<tr>
14803
<td align="left"><b>new_watch</b><i>
14804
</i></td>
14805
<td align="right">Image</td>
14806
</tr>
14807
</table>
14808
<table width="95%" align="center">
14809
<tr><td>
14810
<code>New Watchpoint</code> button.
14811
</td></tr>
14812
</table>
14813
14814
<p>
14815
<table width="100%">
14816
<tr>
14817
<td align="left"><b>plain_arrow</b><i>
14818
</i></td>
14819
<td align="right">Image</td>
14820
</tr>
14821
</table>
14822
<table width="95%" align="center">
14823
<tr><td>
14824
The execution pointer.
14825
</td></tr>
14826
</table>
14827
14828
<p>
14829
<table width="100%">
14830
<tr>
14831
<td align="left"><b>plain_cond</b><i>
14832
</i></td>
14833
<td align="right">Image</td>
14834
</tr>
14835
</table>
14836
<table width="95%" align="center">
14837
<tr><td>
14838
A conditional breakpoint (enabled).
14839
</td></tr>
14840
</table>
14841
14842
<p>
14843
<table width="100%">
14844
<tr>
14845
<td align="left"><b>plain_stop</b><i>
14846
</i></td>
14847
<td align="right">Image</td>
14848
</tr>
14849
</table>
14850
<table width="95%" align="center">
14851
<tr><td>
14852
A breakpoint (enabled).
14853
</td></tr>
14854
</table>
14855
14856
<p>
14857
<table width="100%">
14858
<tr>
14859
<td align="left"><b>plain_temp</b><i>
14860
</i></td>
14861
<td align="right">Image</td>
14862
</tr>
14863
</table>
14864
<table width="95%" align="center">
14865
<tr><td>
14866
A temporary breakpoint (enabled).
14867
</td></tr>
14868
</table>
14869
14870
<p>
14871
<table width="100%">
14872
<tr>
14873
<td align="left"><b>print</b><i>
14874
</i></td>
14875
<td align="right">Image</td>
14876
</tr>
14877
</table>
14878
<table width="95%" align="center">
14879
<tr><td>
14880
<code>Print ()</code> button.
14881
</td></tr>
14882
</table>
14883
14884
<p>
14885
<table width="100%">
14886
<tr>
14887
<td align="left"><b>properties</b><i>
14888
</i></td>
14889
<td align="right">Image</td>
14890
</tr>
14891
</table>
14892
<table width="95%" align="center">
14893
<tr><td>
14894
<code>Properties</code> button.
14895
</td></tr>
14896
</table>
14897
14898
<p>
14899
<table width="100%">
14900
<tr>
14901
<td align="left"><b>rotate</b><i>
14902
</i></td>
14903
<td align="right">Image</td>
14904
</tr>
14905
</table>
14906
<table width="95%" align="center">
14907
<tr><td>
14908
<code>Rotate ()</code> button.
14909
</td></tr>
14910
</table>
14911
14912
<p>
14913
<table width="100%">
14914
<tr>
14915
<td align="left"><b>set</b><i>
14916
</i></td>
14917
<td align="right">Image</td>
14918
</tr>
14919
</table>
14920
<table width="95%" align="center">
14921
<tr><td>
14922
<code>Set ()</code> button.
14923
</td></tr>
14924
</table>
14925
14926
<p>
14927
<table width="100%">
14928
<tr>
14929
<td align="left"><b>show</b><i>
14930
</i></td>
14931
<td align="right">Image</td>
14932
</tr>
14933
</table>
14934
<table width="95%" align="center">
14935
<tr><td>
14936
<code>Show ()</code> button.
14937
</td></tr>
14938
</table>
14939
14940
<p>
14941
<table width="100%">
14942
<tr>
14943
<td align="left"><b>signal_arrow</b><i>
14944
</i></td>
14945
<td align="right">Image</td>
14946
</tr>
14947
</table>
14948
<table width="95%" align="center">
14949
<tr><td>
14950
The execution pointer (stopped by signal).
14951
</td></tr>
14952
</table>
14953
14954
<p>
14955
<table width="100%">
14956
<tr>
14957
<td align="left"><b>undisplay</b><i>
14958
</i></td>
14959
<td align="right">Image</td>
14960
</tr>
14961
</table>
14962
<table width="95%" align="center">
14963
<tr><td>
14964
<code>Undisplay ()</code> button.
14965
</td></tr>
14966
</table>
14967
14968
<p>
14969
<table width="100%">
14970
<tr>
14971
<td align="left"><b>unwatch</b><i>
14972
</i></td>
14973
<td align="right">Image</td>
14974
</tr>
14975
</table>
14976
<table width="95%" align="center">
14977
<tr><td>
14978
<code>Unwatch ()</code> button.
14979
</td></tr>
14980
</table>
14981
14982
<p>
14983
<table width="100%">
14984
<tr>
14985
<td align="left"><b>watch</b><i>
14986
</i></td>
14987
<td align="right">Image</td>
14988
</tr>
14989
</table>
14990
<table width="95%" align="center">
14991
<tr><td>
14992
<code>Watch ()</code> button.
14993
</td></tr>
14994
</table>
12232
<div class="defun">
12233
— Image: <b>break_at</b><var><a name="index-break_005fat-1322"></a></var><br>
12234
<blockquote><p>‘<samp><span class="samp">Break at ()</span></samp>’ button.
12235
</p></blockquote></div>
12236
12237
<div class="defun">
12238
— Image: <b>clear_at</b><var><a name="index-clear_005fat-1323"></a></var><br>
12239
<blockquote><p>‘<samp><span class="samp">Clear at ()</span></samp>’ button.
12240
</p></blockquote></div>
12241
12242
<div class="defun">
12243
— Image: <b>ddd</b><var><a name="index-ddd-1324"></a></var><br>
12244
<blockquote><p><acronym>DDD</acronym> icon.
12245
</p></blockquote></div>
12246
12247
<div class="defun">
12248
— Image: <b>delete</b><var><a name="index-delete-1325"></a></var><br>
12249
<blockquote><p>‘<samp><span class="samp">Delete ()</span></samp>’ button.
12250
</p></blockquote></div>
12251
12252
<div class="defun">
12253
— Image: <b>disable</b><var><a name="index-disable-1326"></a></var><br>
12254
<blockquote><p>‘<samp><span class="samp">Disable</span></samp>’ button.
12255
</p></blockquote></div>
12256
12257
<div class="defun">
12258
— Image: <b>dispref</b><var><a name="index-dispref-1327"></a></var><br>
12259
<blockquote><p>‘<samp><span class="samp">Display * ()</span></samp>’ button.
12260
</p></blockquote></div>
12261
12262
<div class="defun">
12263
— Image: <b>display</b><var><a name="index-display-1328"></a></var><br>
12264
<blockquote><p>‘<samp><span class="samp">Display ()</span></samp>’ button.
12265
</p></blockquote></div>
12266
12267
<div class="defun">
12268
— Image: <b>drag_arrow</b><var><a name="index-drag_005farrow-1329"></a></var><br>
12269
<blockquote><p>The execution pointer (being dragged).
12270
</p></blockquote></div>
12271
12272
<div class="defun">
12273
— Image: <b>drag_cond</b><var><a name="index-drag_005fcond-1330"></a></var><br>
12274
<blockquote><p>A conditional breakpoint (being dragged).
12275
</p></blockquote></div>
12276
12277
<div class="defun">
12278
— Image: <b>drag_stop</b><var><a name="index-drag_005fstop-1331"></a></var><br>
12279
<blockquote><p>A breakpoint (being dragged).
12280
</p></blockquote></div>
12281
12282
<div class="defun">
12283
— Image: <b>drag_temp</b><var><a name="index-drag_005ftemp-1332"></a></var><br>
12284
<blockquote><p>A temporary breakpoint (being dragged).
12285
</p></blockquote></div>
12286
12287
<div class="defun">
12288
— Image: <b>enable</b><var><a name="index-enable-1333"></a></var><br>
12289
<blockquote><p>‘<samp><span class="samp">Enable</span></samp>’ button.
12290
</p></blockquote></div>
12291
12292
<div class="defun">
12293
— Image: <b>find_forward</b><var><a name="index-find_005fforward-1334"></a></var><br>
12294
<blockquote><p>‘<samp><span class="samp">Find>> ()</span></samp>’ button.
12295
</p></blockquote></div>
12296
12297
<div class="defun">
12298
— Image: <b>find_backward</b><var><a name="index-find_005fbackward-1335"></a></var><br>
12299
<blockquote><p>‘<samp><span class="samp">Find<< ()</span></samp>’ button.
12300
</p></blockquote></div>
12301
12302
<div class="defun">
12303
— Image: <b>grey_arrow</b><var><a name="index-grey_005farrow-1336"></a></var><br>
12304
<blockquote><p>The execution pointer (not in lowest frame).
12305
</p></blockquote></div>
12306
12307
<div class="defun">
12308
— Image: <b>grey_cond</b><var><a name="index-grey_005fcond-1337"></a></var><br>
12309
<blockquote><p>A conditional breakpoint (disabled).
12310
</p></blockquote></div>
12311
12312
<div class="defun">
12313
— Image: <b>grey_stop</b><var><a name="index-grey_005fstop-1338"></a></var><br>
12314
<blockquote><p>A breakpoint (disabled).
12315
</p></blockquote></div>
12316
12317
<div class="defun">
12318
— Image: <b>grey_temp</b><var><a name="index-grey_005ftemp-1339"></a></var><br>
12319
<blockquote><p>A temporary breakpoint (disabled).
12320
</p></blockquote></div>
12321
12322
<div class="defun">
12323
— Image: <b>hide</b><var><a name="index-hide-1340"></a></var><br>
12324
<blockquote><p>‘<samp><span class="samp">Hide ()</span></samp>’ button.
12325
</p></blockquote></div>
12326
12327
<div class="defun">
12328
— Image: <b>lookup</b><var><a name="index-lookup-1341"></a></var><br>
12329
<blockquote><p>‘<samp><span class="samp">Lookup ()</span></samp>’ button.
12330
</p></blockquote></div>
12331
12332
<div class="defun">
12333
— Image: <b>maketemp</b><var><a name="index-maketemp-1342"></a></var><br>
12334
<blockquote><p>‘<samp><span class="samp">Make Temporary</span></samp>’ button.
12335
</p></blockquote></div>
12336
12337
<div class="defun">
12338
— Image: <b>new_break</b><var><a name="index-new_005fbreak-1343"></a></var><br>
12339
<blockquote><p>‘<samp><span class="samp">New Breakpoint</span></samp>’ button.
12340
</p></blockquote></div>
12341
12342
<div class="defun">
12343
— Image: <b>new_display</b><var><a name="index-new_005fdisplay-1344"></a></var><br>
12344
<blockquote><p>‘<samp><span class="samp">New Display</span></samp>’ button.
12345
</p></blockquote></div>
12346
12347
<div class="defun">
12348
— Image: <b>new_watch</b><var><a name="index-new_005fwatch-1345"></a></var><br>
12349
<blockquote><p>‘<samp><span class="samp">New Watchpoint</span></samp>’ button.
12350
</p></blockquote></div>
12351
12352
<div class="defun">
12353
— Image: <b>plain_arrow</b><var><a name="index-plain_005farrow-1346"></a></var><br>
12354
<blockquote><p>The execution pointer.
12355
</p></blockquote></div>
12356
12357
<div class="defun">
12358
— Image: <b>plain_cond</b><var><a name="index-plain_005fcond-1347"></a></var><br>
12359
<blockquote><p>A conditional breakpoint (enabled).
12360
</p></blockquote></div>
12361
12362
<div class="defun">
12363
— Image: <b>plain_stop</b><var><a name="index-plain_005fstop-1348"></a></var><br>
12364
<blockquote><p>A breakpoint (enabled).
12365
</p></blockquote></div>
12366
12367
<div class="defun">
12368
— Image: <b>plain_temp</b><var><a name="index-plain_005ftemp-1349"></a></var><br>
12369
<blockquote><p>A temporary breakpoint (enabled).
12370
</p></blockquote></div>
12371
12372
<div class="defun">
12373
— Image: <b>print</b><var><a name="index-print-1350"></a></var><br>
12374
<blockquote><p>‘<samp><span class="samp">Print ()</span></samp>’ button.
12375
</p></blockquote></div>
12376
12377
<div class="defun">
12378
— Image: <b>properties</b><var><a name="index-properties-1351"></a></var><br>
12379
<blockquote><p>‘<samp><span class="samp">Properties</span></samp>’ button.
12380
</p></blockquote></div>
12381
12382
<div class="defun">
12383
— Image: <b>rotate</b><var><a name="index-rotate-1352"></a></var><br>
12384
<blockquote><p>‘<samp><span class="samp">Rotate ()</span></samp>’ button.
12385
</p></blockquote></div>
12386
12387
<div class="defun">
12388
— Image: <b>set</b><var><a name="index-set-1353"></a></var><br>
12389
<blockquote><p>‘<samp><span class="samp">Set ()</span></samp>’ button.
12390
</p></blockquote></div>
12391
12392
<div class="defun">
12393
— Image: <b>show</b><var><a name="index-show-1354"></a></var><br>
12394
<blockquote><p>‘<samp><span class="samp">Show ()</span></samp>’ button.
12395
</p></blockquote></div>
12396
12397
<div class="defun">
12398
— Image: <b>signal_arrow</b><var><a name="index-signal_005farrow-1355"></a></var><br>
12399
<blockquote><p>The execution pointer (stopped by signal).
12400
</p></blockquote></div>
12401
12402
<div class="defun">
12403
— Image: <b>undisplay</b><var><a name="index-undisplay-1356"></a></var><br>
12404
<blockquote><p>‘<samp><span class="samp">Undisplay ()</span></samp>’ button.
12405
</p></blockquote></div>
12406
12407
<div class="defun">
12408
— Image: <b>unwatch</b><var><a name="index-unwatch-1357"></a></var><br>
12409
<blockquote><p>‘<samp><span class="samp">Unwatch ()</span></samp>’ button.
12410
</p></blockquote></div>
12411
12412
<div class="defun">
12413
— Image: <b>watch</b><var><a name="index-watch-1358"></a></var><br>
12414
<blockquote><p>‘<samp><span class="samp">Watch ()</span></samp>’ button.
12415
</p></blockquote></div>
14995
12416
14996
12417
<div class="node">
14997
12418
<p><hr>
14998
<small class=header>
14999
Node:<a name="Bugs">Bugs</a>,
15000
Next:<a rel="next" accesskey="n" href="#Configuration%20Notes">Configuration Notes</a>,
15001
Previous:<a rel="previous" accesskey="p" href="#Application%20Defaults">Application Defaults</a>,
15002
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
12419
<a name="Bugs"></a>
12420
Next: <a rel="next" accesskey="n" href="#Configuration-Notes">Configuration Notes</a>,
12421
Previous: <a rel="previous" accesskey="p" href="#Application-Defaults">Application Defaults</a>,
12422
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
15003
12423
</small>
15004
12424
15005
<br>
12425
15006
12426
</div>
15007
12427
15008
<h2 class="appendix">Bugs and How To Report Them</h2>
12428
<h2 class="appendix">Appendix B Bugs and How To Report Them</h2>
15009
12429
15010
<p>Sometimes you will encounter a bug in <small>DDD</small>. Although we cannot
12430
<p>Sometimes you will encounter a bug in <acronym>DDD</acronym>. Although we cannot
15011
12431
promise we can or will fix the bug, and we might not even agree that it
15012
12432
is a bug, we want to hear about bugs you encounter in case we do want to
15013
12433
fix them.
15016
12436
to do so effectively, you must know when and how to do it.
15017
12437
15018
12438
<ul class="menu">
15019
<li><a accesskey="1" href="#Where%20to%20Send%20Bug%20Reports">Where to Send Bug Reports</a>: Our e-mail address.
15020
<li><a accesskey="2" href="#Is%20it%20a%20%3csmall%3eDDD%3c%2fsmall%3e%20Bug%3f">Is it a <small>DDD</small> Bug?</a>: <small>DDD</small> may not be at fault.
15021
<li><a accesskey="3" href="#How%20to%20Report%20Bugs">How to Report Bugs</a>: Report all the facts.
15022
<li><a accesskey="4" href="#Bug%20Reports">Bug Reports</a>: Include all configuration information.
15023
<li><a accesskey="5" href="#Diagnostics">Diagnostics</a>: Maintaining <small>DDD</small>
12439
<li><a accesskey="1" href="#Where-to-Send-Bug-Reports">Where to Send Bug Reports</a>: Our e-mail address.
12440
<li><a accesskey="2" href="#Is-it-a-_003cacronym_003eDDD_003c_002facronym_003e-Bug_003f">Is it a <acronym>DDD</acronym> Bug?</a>: <acronym>DDD</acronym> may not be at fault.
12441
<li><a accesskey="3" href="#How-to-Report-Bugs">How to Report Bugs</a>: Report all the facts.
12442
<li><a accesskey="4" href="#Bug-Reports">Bug Reports</a>: Include all configuration information.
12443
<li><a accesskey="5" href="#Diagnostics">Diagnostics</a>: Maintaining <acronym>DDD</acronym>
15024
12444
</ul>
15025
12445
15026
12446
<div class="node">
15027
12447
<p><hr>
15028
<small class=header>
15029
Node:<a name="Where%20to%20Send%20Bug%20Reports">Where to Send Bug Reports</a>,
15030
Next:<a rel="next" accesskey="n" href="#Is%20it%20a%20%3csmall%3eDDD%3c%2fsmall%3e%20Bug%3f">Is it a <small>DDD</small> Bug?</a>,
15031
Up:<a rel="up" accesskey="u" href="#Bugs">Bugs</a>
12448
<a name="Where-to-Send-Bug-Reports"></a>
12449
Next: <a rel="next" accesskey="n" href="#Is-it-a-_003cacronym_003eDDD_003c_002facronym_003e-Bug_003f">Is it a <acronym>DDD</acronym> Bug?</a>,
12450
Up: <a rel="up" accesskey="u" href="#Bugs">Bugs</a>
15032
12451
</small>
15033
12452
15034
<br>
12453
15035
12454
</div>
15036
12455
15037
<h3 class="section">Where to Send Bug Reports</h3>
15038
15039
<p>Send bug reports for <small>DDD</small> via electronic mail to
15040
15041
<pre class="example"> <a href="mailto:bug-ddd@gnu.org">bug-ddd@gnu.org</a>
15042
</pre>
12456
<h3 class="section">B.1 Where to Send Bug Reports</h3>
12457
12458
<p>Submit bug reports for <acronym>DDD</acronym> at
12459
<a href="http://savannah.gnu.org/bugs/?group=ddd">http://savannah.gnu.org/bugs/?group=ddd</a>, the <acronym>DDD</acronym> bug
12460
tracker. Incoming bug reports are automatically copied
12461
to the developers' mailing list <a href="mailto:bug-ddd@gnu.org">bug-ddd@gnu.org</a>.
15043
12462
15044
12463
<div class="node">
15045
12464
<p><hr>
15046
<small class=header>
15047
Node:<a name="Is%20it%20a%20%3csmall%3eDDD%3c%2fsmall%3e%20Bug%3f">Is it a <small>DDD</small> Bug?</a>,
15048
Next:<a rel="next" accesskey="n" href="#How%20to%20Report%20Bugs">How to Report Bugs</a>,
15049
Previous:<a rel="previous" accesskey="p" href="#Where%20to%20Send%20Bug%20Reports">Where to Send Bug Reports</a>,
15050
Up:<a rel="up" accesskey="u" href="#Bugs">Bugs</a>
12465
<a name="Is-it-a-%3cacronym%3eDDD%3c%2facronym%3e-Bug%3f"></a>
12466
<a name="Is-it-a-_003cacronym_003eDDD_003c_002facronym_003e-Bug_003f"></a>
12467
Next: <a rel="next" accesskey="n" href="#How-to-Report-Bugs">How to Report Bugs</a>,
12468
Previous: <a rel="previous" accesskey="p" href="#Where-to-Send-Bug-Reports">Where to Send Bug Reports</a>,
12469
Up: <a rel="up" accesskey="u" href="#Bugs">Bugs</a>
15051
12470
</small>
15052
12471
15053
<br>
12472
15054
12473
</div>
15055
12474
15056
<h3 class="section">Is it a DDD Bug?</h3>
12475
<h3 class="section">B.2 Is it a DDD Bug?</h3>
15057
12476
15058
<p>Before sending in a bug report, try to find out whether the problem
15059
cause really lies within <small>DDD</small>. A common cause of problems
12477
<p>Before sending in a bug report, try to find out whether the problem
12478
cause really lies within <acronym>DDD</acronym>. A common cause of problems
15060
12479
are incomplete or missing X or M*tif installations, for instance, or
15061
bugs in the X server or M*tif itself. Running <small>DDD</small> as
12480
bugs in the X server or M*tif itself. Running <acronym>DDD</acronym> as
15062
12481
15063
12482
<pre class="example"> $ <kbd>ddd --check-configuration</kbd>
15064
</pre>
15065
12483
</pre>
15066
12484
<p>checks for common problems and gives hints on how to repair them.
15067
12485
15068
12486
<p>Another potential cause of problems is the inferior debugger;
15069
12487
occasionally, they show bugs, too. To find out whether a bug was
15070
caused by the inferior debugger, run <small>DDD</small> as
12488
caused by the inferior debugger, run <acronym>DDD</acronym> as
15071
12489
15072
12490
<pre class="example"> $ <kbd>ddd --trace</kbd>
15073
</pre>
15074
15075
<p>This shows the interaction between <small>DDD</small> and the inferior debugger
15076
on standard error while <small>DDD</small> is running. (If <code>--trace</code> is
12491
</pre>
12492
<p>This shows the interaction between <acronym>DDD</acronym> and the inferior debugger
12493
on standard error while <acronym>DDD</acronym> is running. (If <samp><span class="option">--trace</span></samp> is
15077
12494
not given, this interaction is logged in the file
15078
<code>~/.ddd/log</code>; see <a href="#Logging">Logging</a>) Compare the debugger output
15079
to the output of <small>DDD</small> and determine which one is wrong.
12495
<samp><span class="file">~/.ddd/log</span></samp>; see <a href="#Logging">Logging</a>) Compare the debugger output
12496
to the output of <acronym>DDD</acronym> and determine which one is wrong.
15080
12497
15081
12498
<div class="node">
15082
12499
<p><hr>
15083
<small class=header>
15084
Node:<a name="How%20to%20Report%20Bugs">How to Report Bugs</a>,
15085
Next:<a rel="next" accesskey="n" href="#Bug%20Reports">Bug Reports</a>,
15086
Previous:<a rel="previous" accesskey="p" href="#Is%20it%20a%20%3csmall%3eDDD%3c%2fsmall%3e%20Bug%3f">Is it a <small>DDD</small> Bug?</a>,
15087
Up:<a rel="up" accesskey="u" href="#Bugs">Bugs</a>
12500
<a name="How-to-Report-Bugs"></a>
12501
Next: <a rel="next" accesskey="n" href="#Bug-Reports">Bug Reports</a>,
12502
Previous: <a rel="previous" accesskey="p" href="#Is-it-a-_003cacronym_003eDDD_003c_002facronym_003e-Bug_003f">Is it a <acronym>DDD</acronym> Bug?</a>,
12503
Up: <a rel="up" accesskey="u" href="#Bugs">Bugs</a>
15088
12504
</small>
15089
12505
15090
<br>
12506
15091
12507
</div>
15092
12508
15093
<h3 class="section">How to Report Bugs</h3>
12509
<h3 class="section">B.3 How to Report Bugs</h3>
15094
12510
15095
<p>Here are some guidelines for bug reports:
12511
<p>Here are some guidelines for bug reports:
15096
12512
15097
12513
<ul>
15098
12514
<li>The fundamental principle of reporting bugs usefully is this:
15119
12535
15120
12536
<div class="node">
15121
12537
<p><hr>
15122
<small class=header>
15123
Node:<a name="Bug%20Reports">Bug Reports</a>,
15124
Next:<a rel="next" accesskey="n" href="#Diagnostics">Diagnostics</a>,
15125
Previous:<a rel="previous" accesskey="p" href="#How%20to%20Report%20Bugs">How to Report Bugs</a>,
15126
Up:<a rel="up" accesskey="u" href="#Bugs">Bugs</a>
12538
<a name="Bug-Reports"></a>
12539
Next: <a rel="next" accesskey="n" href="#Diagnostics">Diagnostics</a>,
12540
Previous: <a rel="previous" accesskey="p" href="#How-to-Report-Bugs">How to Report Bugs</a>,
12541
Up: <a rel="up" accesskey="u" href="#Bugs">Bugs</a>
15127
12542
</small>
15128
12543
15129
<br>
12544
15130
12545
</div>
15131
12546
15132
<h3 class="section">What to Include in a Bug Report</h3>
12547
<h3 class="section">B.4 What to Include in a Bug Report</h3>
15133
12548
15134
<p>To enable us to fix a <small>DDD</small> bug, you <em>must</em> include the
12549
<p>To enable us to fix a <acronym>DDD</acronym> bug, you <em>must</em> include the
15135
12550
following information:
15136
12551
15137
12552
<ul>
15138
<li>Your <small>DDD</small> configuration. Invoke <small>DDD</small> as
12553
<li>Your <acronym>DDD</acronym> configuration. Invoke <acronym>DDD</acronym> as
15139
12554
15140
12555
<pre class="example"> $ <kbd>ddd --configuration</kbd>
15141
</pre>
15142
12556
</pre>
15143
12557
<p>to get the configuration information. If this does not work, please
15144
include at least the <small>DDD</small> version, the type of machine you
12558
include at least the <acronym>DDD</acronym> version, the type of machine you
15145
12559
are using, and its operating system name and version number.
15146
12560
15147
</p><li>The debugger you are using and its version (e.g., <code>gdb-4.17</code> or
15148
<code>dbx as shipped with Solaris 2.6</code>).
12561
<li>The debugger you are using and its version (e.g., ‘<samp><span class="samp">gdb-4.17</span></samp>’ or
12562
‘<samp><span class="samp">dbx as shipped with Solaris 2.6</span></samp>’).
15149
12563
15150
<li>The compiler you used to compile <small>DDD</small> and its version (e.g.,
15151
<code>gcc-2.8.1</code>).
12564
<li>The compiler you used to compile <acronym>DDD</acronym> and its version (e.g.,
12565
‘<samp><span class="samp">gcc-2.8.1</span></samp>’).
15152
12566
15153
12567
<li>A description of what behavior you observe that you believe is
15154
incorrect. For example, "<small>DDD</small> gets a fatal signal"
15155
or "<small>DDD</small> exits immediately after attempting to create the
15156
data window".
12568
incorrect. For example, “<acronym>DDD</acronym> gets a fatal signal”
12569
or “<acronym>DDD</acronym> exits immediately after attempting to create the
12570
data window“.
15157
12571
15158
<li>A <em>log file</em> showing the interaction between <small>DDD</small> and the
12572
<li>A <em>log file</em> showing the interaction between <acronym>DDD</acronym> and the
15159
12573
inferior debugger. By default, this interaction is logged in the file
15160
<code>~/.ddd/log</code>. Include all trace output from the
15161
<small>DDD</small> invocation up to the first bug occurrence; insert own
12574
<samp><span class="file">~/.ddd/log</span></samp>. Include all trace output from the
12575
<acronym>DDD</acronym> invocation up to the first bug occurrence; insert own
15162
12576
comments where necessary.
15163
12577
15164
<li>If you wish to suggest changes to the <small>DDD</small> source, send us context
15165
diffs. If you even discuss something in the <small>DDD</small> source, refer to
12578
<li>If you wish to suggest changes to the <acronym>DDD</acronym> source, send us context
12579
diffs. If you even discuss something in the <acronym>DDD</acronym> source, refer to
15166
12580
it by context, <em>never</em> by line number.
15167
12581
</ul>
15168
12582
15170
12584
15171
12585
<div class="node">
15172
12586
<p><hr>
15173
<small class=header>
15174
Node:<a name="Diagnostics">Diagnostics</a>,
15175
Previous:<a rel="previous" accesskey="p" href="#Bug%20Reports">Bug Reports</a>,
15176
Up:<a rel="up" accesskey="u" href="#Bugs">Bugs</a>
12587
<a name="Diagnostics"></a>
12588
Previous: <a rel="previous" accesskey="p" href="#Bug-Reports">Bug Reports</a>,
12589
Up: <a rel="up" accesskey="u" href="#Bugs">Bugs</a>
15177
12590
</small>
15178
12591
15179
<br>
12592
15180
12593
</div>
15181
12594
15182
<h3 class="section">Getting Diagnostics</h3>
12595
<h3 class="section">B.5 Getting Diagnostics</h3>
15183
12596
15184
12597
<ul class="menu">
15185
<li><a accesskey="1" href="#Logging">Logging</a>: <small>DDD</small> logs all interactions.
15186
<li><a accesskey="2" href="#Debugging%20%3csmall%3eDDD%3c%2fsmall%3e">Debugging <small>DDD</small></a>: Facilities to debug <small>DDD</small>.
15187
<li><a accesskey="3" href="#Customizing%20Diagnostics">Customizing Diagnostics</a>: All diagnostics resources.
12598
<li><a accesskey="1" href="#Logging">Logging</a>: <acronym>DDD</acronym> logs all interactions.
12599
<li><a accesskey="2" href="#Debugging-_003cacronym_003eDDD_003c_002facronym_003e">Debugging <acronym>DDD</acronym></a>: Facilities to debug <acronym>DDD</acronym>.
12600
<li><a accesskey="3" href="#Customizing-Diagnostics">Customizing Diagnostics</a>: All diagnostics resources.
15188
12601
</ul>
15189
12602
15190
12603
<div class="node">
15191
12604
<p><hr>
15192
<small class=header>
15193
Node:<a name="Logging">Logging</a>,
15194
Next:<a rel="next" accesskey="n" href="#Debugging%20%3csmall%3eDDD%3c%2fsmall%3e">Debugging <small>DDD</small></a>,
15195
Up:<a rel="up" accesskey="u" href="#Diagnostics">Diagnostics</a>
12605
<a name="Logging"></a>
12606
Next: <a rel="next" accesskey="n" href="#Debugging-_003cacronym_003eDDD_003c_002facronym_003e">Debugging <acronym>DDD</acronym></a>,
12607
Up: <a rel="up" accesskey="u" href="#Diagnostics">Diagnostics</a>
15196
12608
</small>
15197
12609
15198
<br>
12610
15199
12611
</div>
15200
12612
15201
<h4 class="subsection">Logging</h4>
12613
<h4 class="subsection">B.5.1 Logging</h4>
15202
12614
15203
<p>If things go wrong, the first and most important information source is
15204
the <dfn></dfn><small>DDD</small><dfn> log file</dfn>. This file, created in
15205
<code>~/.ddd/log</code> (<code>~</code> stands for your home directory),
12615
<p><a name="index-Logging-1359"></a><a name="index-log-1360"></a>If things go wrong, the first and most important information source is
12616
the <dfn><acronym>DDD</acronym> log file</dfn>. This file, created in
12617
<samp><span class="file">~/.ddd/log</span></samp> (<samp><span class="file">~</span></samp> stands for your home directory),
15206
12618
records the following information:
15207
12619
15208
12620
<ul>
15209
<li>Your <small>DDD</small> configuration (at the top)
15210
15211
<li>All programs invoked by <small>DDD</small>, shown as
15212
<code>$ </code><kbd></kbd><var>program</var><kbd> </kbd><var>args</var><kbd>...</kbd><code></code>
15213
15214
<li>All <small>DDD</small> messages, shown as <code># </code><var>message</var><code></code>.
15215
15216
<li>All information sent from <small>DDD</small> to the inferior debugger,
15217
shown as <code>-> </code><var>text</var><code></code>.
12621
<li>Your <acronym>DDD</acronym> configuration (at the top)
12622
12623
<li>All programs invoked by <acronym>DDD</acronym>, shown as
12624
‘<samp><span class="samp">$ </span><var>program</var> <var>args</var><kbd>...</kbd></samp>’
12625
12626
<li>All <acronym>DDD</acronym> messages, shown as ‘<samp><span class="samp"># </span><var>message</var></samp>’.
12627
12628
<li>All information sent from <acronym>DDD</acronym> to the inferior debugger,
12629
shown as <samp><span class="option">-> </span><var>text</var></samp>.
15218
12630
15219
12631
<li>All information sent from the inferior debugger standard output to
15220
<small>DDD</small>, shown as <code><- </code><var>text</var><code></code>.
12632
<acronym>DDD</acronym>, shown as ‘<samp><span class="samp"><- </span><var>text</var></samp>’.
15221
12633
15222
12634
<li>All information sent from the inferior debugger standard error to
15223
<small>DDD</small>, shown as <code><= </code><var>text</var><code></code>.<a rel="footnote" href="#fn-33"><sup>33</sup></a>
12635
<acronym>DDD</acronym>, shown as ‘<samp><span class="samp"><= </span><var>text</var></samp>’.<a rel="footnote" href="#fn-33" name="fnd-33"><sup>33</sup></a>
15224
12636
15225
<li>All information sent from <small>DDD</small> to Gnuplot,
15226
shown as <code>>> </code><var>text</var><code></code>.
12637
<li>All information sent from <acronym>DDD</acronym> to Gnuplot,
12638
shown as ‘<samp><span class="samp">>> </span><var>text</var></samp>’.
15227
12639
15228
12640
<li>All information sent from Gnuplot standard output to
15229
<small>DDD</small>, shown as <code><< </code><var>text</var><code></code>.
12641
<acronym>DDD</acronym>, shown as ‘<samp><span class="samp"><< </span><var>text</var></samp>’.
15230
12642
15231
12643
<li>All information sent from Gnuplot standard error to
15232
<small>DDD</small>, shown as <code><= </code><var>text</var><code></code>.
12644
<acronym>DDD</acronym>, shown as ‘<samp><span class="samp"><= </span><var>text</var></samp>’.
15233
12645
15234
<li>If <small>DDD</small> crashes, a <small>GDB</small> backtrace of the <small>DDD</small> core dump
12646
<li>If <acronym>DDD</acronym> crashes, a <acronym>GDB</acronym> backtrace of the <acronym>DDD</acronym> core dump
15235
12647
is included at the end.
15236
12648
</ul>
15237
12649
15238
12650
<p>This information, all in one place, should give you (and anyone
15239
maintaining <small>DDD</small>) a first insight of what's going wrong.
12651
maintaining <acronym>DDD</acronym>) a first insight of what's going wrong.
15240
12652
15241
12653
<ul class="menu">
15242
<li><a accesskey="1" href="#Disabling%20Logging">Disabling Logging</a>:
12654
<li><a accesskey="1" href="#Disabling-Logging">Disabling Logging</a>
15243
12655
</ul>
15244
12656
15245
12657
<div class="node">
15246
12658
<p><hr>
15247
<small class=header>
15248
Node:<a name="Disabling%20Logging">Disabling Logging</a>,
15249
Up:<a rel="up" accesskey="u" href="#Logging">Logging</a>
12659
<a name="Disabling-Logging"></a>
12660
Up: <a rel="up" accesskey="u" href="#Logging">Logging</a>
15250
12661
</small>
15251
12662
15252
<br>
12663
15253
12664
</div>
15254
12665
15255
<h5 class="subsubsection">Disabling Logging</h5>
12666
<h5 class="subsubsection">B.5.1.1 Disabling Logging</h5>
15256
12667
15257
<p>The log files created by <small>DDD</small> can become quite large, so you
15258
might want to turn off logging. There is no explicit <small>DDD</small>
12668
<p><a name="index-Logging_002c-disabling-1361"></a>The log files created by <acronym>DDD</acronym> can become quite large, so you
12669
might want to turn off logging. There is no explicit <acronym>DDD</acronym>
15259
12670
feature that allows you to do that. However, you can easily create a
15260
<em>symbolic link</em> from <code>~/.ddd/log</code> to <code>/dev/null</code>,
12671
<em>symbolic link</em> from <samp><span class="file">~/.ddd/log</span></samp> to ‘<samp><span class="samp">/dev/null</span></samp>’,
15261
12672
such that logging information is lost. Enter the following commands at
15262
12673
the shell prompt:
15263
12674
15265
12676
$ <kbd>rm .ddd/log</kbd>
15266
12677
$ <kbd>ln -s /dev/null .ddd/log</kbd>
15267
12678
$ _
15268
</pre>
15269
12679
</pre>
15270
12680
<p>Be aware, though, that having logging turned off makes diagnostics much
15271
12681
more difficult; in case of trouble, it may be hard to reproduce the
15272
12682
error.
15273
12683
15274
12684
<div class="node">
15275
12685
<p><hr>
15276
<small class=header>
15277
Node:<a name="Debugging%20%3csmall%3eDDD%3c%2fsmall%3e">Debugging <small>DDD</small></a>,
15278
Next:<a rel="next" accesskey="n" href="#Customizing%20Diagnostics">Customizing Diagnostics</a>,
15279
Previous:<a rel="previous" accesskey="p" href="#Logging">Logging</a>,
15280
Up:<a rel="up" accesskey="u" href="#Diagnostics">Diagnostics</a>
12686
<a name="Debugging-%3cacronym%3eDDD%3c%2facronym%3e"></a>
12687
<a name="Debugging-_003cacronym_003eDDD_003c_002facronym_003e"></a>
12688
Next: <a rel="next" accesskey="n" href="#Customizing-Diagnostics">Customizing Diagnostics</a>,
12689
Previous: <a rel="previous" accesskey="p" href="#Logging">Logging</a>,
12690
Up: <a rel="up" accesskey="u" href="#Diagnostics">Diagnostics</a>
15281
12691
</small>
15282
12692
15283
<br>
12693
15284
12694
</div>
15285
12695
15286
<h4 class="subsection">Debugging DDD</h4>
15287
15288
<p>As long as <small>DDD</small> is compiled with <code>-g</code> (see <a href="#Compiling%20for%20Debugging">Compiling for Debugging</a>), you can invoke a debugger on <small>DDD</small>--even <small>DDD</small>
15289
itself, if you wish. From within <small>DDD</small>, a special
15290
<code>Maintenance</code> menu is provided that invokes <small>GDB</small> on the running
15291
<small>DDD</small> process. See <a href="#Maintenance%20Menu">Maintenance Menu</a>, for details.
15292
15293
<p>The <small>DDD</small> distribution comes with a <code>.gdbinit</code> file that is
15294
suitable for debugging <small>DDD</small>. Among others, this defines a
15295
<code>ddd</code> command that sets up an environment for debugging <small>DDD</small>
15296
and a <code>string</code> command that lets you print the contents of
15297
<small>DDD</small> <code>string</code> variables; just use <code>print </code><var>var</var><code></code>
15298
followed by <code>string</code>.
15299
15300
<p>You can cause <small>DDD</small> to dump core at any time by sending it a
15301
<code>SIGUSR1</code> signal. <small>DDD</small> resumes execution while you can examine
15302
the core file with <small>GDB</small>.
15303
15304
<p>When debugging <small>DDD</small>, it can be useful to make <small>DDD</small> not
12696
<h4 class="subsection">B.5.2 Debugging DDD</h4>
12697
12698
<p><a name="index-Debugging-_0040DDD_007b_007d-1362"></a>As long as <acronym>DDD</acronym> is compiled with <samp><span class="option">-g</span></samp> (see <a href="#Compiling-for-Debugging">Compiling for Debugging</a>), you can invoke a debugger on <acronym>DDD</acronym>—even <acronym>DDD</acronym>
12699
itself, if you wish. From within <acronym>DDD</acronym>, a special
12700
‘<samp><span class="samp">Maintenance</span></samp>’ menu is provided that invokes <acronym>GDB</acronym> on the running
12701
<acronym>DDD</acronym> process. See <a href="#Maintenance-Menu">Maintenance Menu</a>, for details.
12702
12703
<p><a name="index-g_t_002egdbinit-1363"></a>The <acronym>DDD</acronym> distribution comes with a <samp><span class="file">.gdbinit</span></samp> file that is
12704
suitable for debugging <acronym>DDD</acronym>. Among others, this defines a
12705
‘<samp><span class="samp">ddd</span></samp>’ command that sets up an environment for debugging <acronym>DDD</acronym>
12706
and a ‘<samp><span class="samp">string</span></samp>’ command that lets you print the contents of
12707
<acronym>DDD</acronym> ‘<samp><span class="samp">string</span></samp>’ variables; just use ‘<samp><span class="samp">print </span><var>var</var></samp>’
12708
followed by ‘<samp><span class="samp">string</span></samp>’.
12709
12710
<p><a name="index-SIGUSR1-signal-1364"></a>You can cause <acronym>DDD</acronym> to dump core at any time by sending it a
12711
<code>SIGUSR1</code> signal. <acronym>DDD</acronym> resumes execution while you can examine
12712
the core file with <acronym>GDB</acronym>.
12713
12714
<p><a name="index-DDD_005fNO_005fSIGNAL_005fHANDLERS-1365"></a>When debugging <acronym>DDD</acronym>, it can be useful to make <acronym>DDD</acronym> not
15305
12715
catch fatal errors. This can be achieved by setting the environment
15306
variable <code>DDD_NO_SIGNAL_HANDLERS</code> before invoking
15307
<small>DDD</small>.
12716
variable <samp><span class="env">DDD_NO_SIGNAL_HANDLERS</span></samp> before invoking
12717
<acronym>DDD</acronym>.
15308
12718
15309
12719
<div class="node">
15310
12720
<p><hr>
15311
<small class=header>
15312
Node:<a name="Customizing%20Diagnostics">Customizing Diagnostics</a>,
15313
Previous:<a rel="previous" accesskey="p" href="#Debugging%20%3csmall%3eDDD%3c%2fsmall%3e">Debugging <small>DDD</small></a>,
15314
Up:<a rel="up" accesskey="u" href="#Diagnostics">Diagnostics</a>
12721
<a name="Customizing-Diagnostics"></a>
12722
Previous: <a rel="previous" accesskey="p" href="#Debugging-_003cacronym_003eDDD_003c_002facronym_003e">Debugging <acronym>DDD</acronym></a>,
12723
Up: <a rel="up" accesskey="u" href="#Diagnostics">Diagnostics</a>
15315
12724
</small>
15316
12725
15317
<br>
12726
15318
12727
</div>
15319
12728
15320
<h4 class="subsection">Customizing Diagnostics</h4>
15321
15322
<p>You can use these additional resources to obtain diagnostics about
15323
<small>DDD</small>. Most of them are tied to a particular invocation option.
15324
15325
<p>
15326
<table width="100%">
15327
<tr>
15328
<td align="left"><b>appDefaultsVersion</b><i> </i>(<i>class Version</i>)<i>
15329
</i></td>
15330
<td align="right">Resource</td>
15331
</tr>
15332
</table>
15333
<table width="95%" align="center">
15334
<tr><td>
15335
The version of the <small>DDD</small> app-defaults file. If this string
15336
does not match the version of the current <small>DDD</small> executable,
15337
<small>DDD</small> issues a warning.
15338
</td></tr>
15339
</table>
15340
15341
<p>
15342
<table width="100%">
15343
<tr>
15344
<td align="left"><b>checkConfiguration</b><i> </i>(<i>class CheckConfiguration</i>)<i>
15345
</i></td>
15346
<td align="right">Resource</td>
15347
</tr>
15348
</table>
15349
<table width="95%" align="center">
15350
<tr><td>
15351
If <code>on</code>, check the <small>DDD</small> environment (in particular, the
12729
<h4 class="subsection">B.5.3 Customizing Diagnostics</h4>
12730
12731
<p>You can use these additional resources to obtain diagnostics about
12732
<acronym>DDD</acronym>. Most of them are tied to a particular invocation option.
12733
12734
<div class="defun">
12735
— Resource: <b>appDefaultsVersion</b> (<var>class Version</var>)<var><a name="index-appDefaultsVersion-1366"></a></var><br>
12736
<blockquote><p>The version of the <acronym>DDD</acronym> app-defaults file. If this string
12737
does not match the version of the current <acronym>DDD</acronym> executable,
12738
<acronym>DDD</acronym> issues a warning.
12739
</p></blockquote></div>
12740
12741
<div class="defun">
12742
— Resource: <b>checkConfiguration</b> (<var>class CheckConfiguration</var>)<var><a name="index-checkConfiguration-1367"></a></var><br>
12743
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, check the <acronym>DDD</acronym> environment (in particular, the
15352
12744
X configuration), report any possible problem causes and exit.
15353
See <a href="#Options">Options</a>, for the <code>--check-configuration</code> option.
15354
</td></tr>
15355
</table>
12745
See <a href="#Options">Options</a>, for the <samp><span class="option">--check-configuration</span></samp> option.
12746
</p></blockquote></div>
15356
12747
15357
<p>
15358
<table width="100%">
15359
<tr>
15360
<td align="left"><b>dddinitVersion</b><i> </i>(<i>class Version</i>)<i>
15361
</i></td>
15362
<td align="right">Resource</td>
15363
</tr>
15364
</table>
15365
<table width="95%" align="center">
15366
<tr><td>
15367
The version of the <small>DDD</small> executable that last wrote the
15368
<code>~/.ddd/init</code> file. If this string does not match the
15369
version of the current <small>DDD</small> executable, <small>DDD</small> issues
12748
<div class="defun">
12749
— Resource: <b>dddinitVersion</b> (<var>class Version</var>)<var><a name="index-dddinitVersion-1368"></a></var><br>
12750
<blockquote><p>The version of the <acronym>DDD</acronym> executable that last wrote the
12751
<samp><span class="file">~/.ddd/init</span></samp> file. If this string does not match the
12752
version of the current <acronym>DDD</acronym> executable, <acronym>DDD</acronym> issues
15370
12753
a warning.
15371
</td></tr>
15372
</table>
15373
15374
<p>
15375
<table width="100%">
15376
<tr>
15377
<td align="left"><b>debugCoreDumps</b><i> </i>(<i>class DebugCoreDumps</i>)<i>
15378
</i></td>
15379
<td align="right">Resource</td>
15380
</tr>
15381
</table>
15382
<table width="95%" align="center">
15383
<tr><td>
15384
If <code>on</code>, <small>DDD</small> invokes a debugger on itself when receiving a
15385
fatal signal. See <a href="#Maintenance%20Menu">Maintenance Menu</a>, for setting this resource.
15386
</td></tr>
15387
</table>
15388
15389
<p>
15390
<table width="100%">
15391
<tr>
15392
<td align="left"><b>dumpCore</b><i> </i>(<i>class DumpCore</i>)<i>
15393
</i></td>
15394
<td align="right">Resource</td>
15395
</tr>
15396
</table>
15397
<table width="95%" align="center">
15398
<tr><td>
15399
If <code>on</code> (default), <small>DDD</small> dumps core when receiving a
15400
fatal signal. See <a href="#Maintenance%20Menu">Maintenance Menu</a>, for setting this resource.
15401
</td></tr>
15402
</table>
15403
15404
<p>
15405
<table width="100%">
15406
<tr>
15407
<td align="left"><b>maintenance</b><i> </i>(<i>class Maintenance</i>)<i>
15408
</i></td>
15409
<td align="right">Resource</td>
15410
</tr>
15411
</table>
15412
<table width="95%" align="center">
15413
<tr><td>
15414
If <code>on</code>, enables the top-level <code>Maintenance</code> menu
15415
(see <a href="#Maintenance%20Menu">Maintenance Menu</a>) with additional options. See <a href="#Options">Options</a>, for
15416
the <code>--maintenance</code> option.
15417
</td></tr>
15418
</table>
15419
15420
<p>
15421
<table width="100%">
15422
<tr>
15423
<td align="left"><b>showConfiguration</b><i> </i>(<i>class ShowConfiguration</i>)<i>
15424
</i></td>
15425
<td align="right">Resource</td>
15426
</tr>
15427
</table>
15428
<table width="95%" align="center">
15429
<tr><td>
15430
If <code>on</code>, show the <small>DDD</small> configuration on standard output and
15431
exit. See <a href="#Options">Options</a>, for the <code>--configuration</code> option.
15432
</td></tr>
15433
</table>
15434
15435
<p>
15436
<table width="100%">
15437
<tr>
15438
<td align="left"><b>showFonts</b><i> </i>(<i>class ShowFonts</i>)<i>
15439
</i></td>
15440
<td align="right">Resource</td>
15441
</tr>
15442
</table>
15443
<table width="95%" align="center">
15444
<tr><td>
15445
If <code>on</code>, show the <small>DDD</small> font definitions on standard output
15446
and exit. See <a href="#Options">Options</a>, for the <code>--fonts</code> option.
15447
</td></tr>
15448
</table>
15449
15450
<p>
15451
<table width="100%">
15452
<tr>
15453
<td align="left"><b>showInvocation</b><i> </i>(<i>class ShowInvocation</i>)<i>
15454
</i></td>
15455
<td align="right">Resource</td>
15456
</tr>
15457
</table>
15458
<table width="95%" align="center">
15459
<tr><td>
15460
If <code>on</code>, show the <small>DDD</small> invocation options on standard
15461
output and exit. See <a href="#Options">Options</a>, for the <code>--help</code> option.
15462
</td></tr>
15463
</table>
15464
15465
<p>
15466
<table width="100%">
15467
<tr>
15468
<td align="left"><b>showLicense</b><i> </i>(<i>class ShowLicense</i>)<i>
15469
</i></td>
15470
<td align="right">Resource</td>
15471
</tr>
15472
</table>
15473
<table width="95%" align="center">
15474
<tr><td>
15475
If <code>on</code>, show the <small>DDD</small> license on standard output and
15476
exit. See <a href="#Options">Options</a>, for the <code>--license</code> option.
15477
</td></tr>
15478
</table>
15479
15480
<p>
15481
<table width="100%">
15482
<tr>
15483
<td align="left"><b>showManual</b><i> </i>(<i>class ShowManual</i>)<i>
15484
</i></td>
15485
<td align="right">Resource</td>
15486
</tr>
15487
</table>
15488
<table width="95%" align="center">
15489
<tr><td>
15490
If <code>on</code>, show this <small>DDD</small> manual page on standard output and exit.
12754
</p></blockquote></div>
12755
12756
<div class="defun">
12757
— Resource: <b>debugCoreDumps</b> (<var>class DebugCoreDumps</var>)<var><a name="index-debugCoreDumps-1369"></a></var><br>
12758
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, <acronym>DDD</acronym> invokes a debugger on itself when receiving a
12759
fatal signal. See <a href="#Maintenance-Menu">Maintenance Menu</a>, for setting this resource.
12760
</p></blockquote></div>
12761
12762
<div class="defun">
12763
— Resource: <b>dumpCore</b> (<var>class DumpCore</var>)<var><a name="index-dumpCore-1370"></a></var><br>
12764
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’ (default), <acronym>DDD</acronym> dumps core when receiving a
12765
fatal signal. See <a href="#Maintenance-Menu">Maintenance Menu</a>, for setting this resource.
12766
</p></blockquote></div>
12767
12768
<div class="defun">
12769
— Resource: <b>maintenance</b> (<var>class Maintenance</var>)<var><a name="index-maintenance-1371"></a></var><br>
12770
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, enables the top-level ‘<samp><span class="samp">Maintenance</span></samp>’ menu
12771
(see <a href="#Maintenance-Menu">Maintenance Menu</a>) with additional options. See <a href="#Options">Options</a>, for
12772
the <samp><span class="option">--maintenance</span></samp> option.
12773
</p></blockquote></div>
12774
12775
<div class="defun">
12776
— Resource: <b>showConfiguration</b> (<var>class ShowConfiguration</var>)<var><a name="index-showConfiguration-1372"></a></var><br>
12777
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, show the <acronym>DDD</acronym> configuration on standard output and
12778
exit. See <a href="#Options">Options</a>, for the <samp><span class="option">--configuration</span></samp> option.
12779
</p></blockquote></div>
12780
12781
<div class="defun">
12782
— Resource: <b>showFonts</b> (<var>class ShowFonts</var>)<var><a name="index-showFonts-1373"></a></var><br>
12783
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, show the <acronym>DDD</acronym> font definitions on standard output
12784
and exit. See <a href="#Options">Options</a>, for the <samp><span class="option">--fonts</span></samp> option.
12785
</p></blockquote></div>
12786
12787
<div class="defun">
12788
— Resource: <b>showInvocation</b> (<var>class ShowInvocation</var>)<var><a name="index-showInvocation-1374"></a></var><br>
12789
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, show the <acronym>DDD</acronym> invocation options on standard
12790
output and exit. See <a href="#Options">Options</a>, for the <samp><span class="option">--help</span></samp> option.
12791
</p></blockquote></div>
12792
12793
<div class="defun">
12794
— Resource: <b>showLicense</b> (<var>class ShowLicense</var>)<var><a name="index-showLicense-1375"></a></var><br>
12795
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, show the <acronym>DDD</acronym> license on standard output and
12796
exit. See <a href="#Options">Options</a>, for the <samp><span class="option">--license</span></samp> option.
12797
</p></blockquote></div>
12798
12799
<div class="defun">
12800
— Resource: <b>showManual</b> (<var>class ShowManual</var>)<var><a name="index-showManual-1376"></a></var><br>
12801
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, show this <acronym>DDD</acronym> manual page on standard output and exit.
15491
12802
If the standard output is a terminal, the manual page is shown in a
15492
pager (<code>$PAGER</code>, <code>less</code> or <code>more</code>).
15493
See <a href="#Options">Options</a>, for the <code>--manual</code> option.
15494
</td></tr>
15495
</table>
15496
15497
<p>
15498
<table width="100%">
15499
<tr>
15500
<td align="left"><b>showNews</b><i> </i>(<i>class ShowNews</i>)<i>
15501
</i></td>
15502
<td align="right">Resource</td>
15503
</tr>
15504
</table>
15505
<table width="95%" align="center">
15506
<tr><td>
15507
If <code>on</code>, show the <small>DDD</small> news on standard output and
15508
exit. See <a href="#Options">Options</a>, for the <code>--news</code> option.
15509
</td></tr>
15510
</table>
15511
15512
<p>
15513
<table width="100%">
15514
<tr>
15515
<td align="left"><b>showVersion</b><i> </i>(<i>class ShowVersion</i>)<i>
15516
</i></td>
15517
<td align="right">Resource</td>
15518
</tr>
15519
</table>
15520
<table width="95%" align="center">
15521
<tr><td>
15522
If <code>on</code>, show the <small>DDD</small> version on standard output and
15523
exit. See <a href="#Options">Options</a>, for the <code>--version</code> option.
15524
</td></tr>
15525
</table>
15526
15527
<p>
15528
<table width="100%">
15529
<tr>
15530
<td align="left"><b>suppressWarnings</b><i> </i>(<i>class SuppressWarnings</i>)<i>
15531
</i></td>
15532
<td align="right">Resource</td>
15533
</tr>
15534
</table>
15535
<table width="95%" align="center">
15536
<tr><td>
15537
If <code>on</code>, X warnings are suppressed. This is sometimes useful for
12803
pager (<samp><span class="command">$PAGER</span></samp>, <samp><span class="command">less</span></samp> or <samp><span class="command">more</span></samp>).
12804
See <a href="#Options">Options</a>, for the <samp><span class="option">--manual</span></samp> option.
12805
<a name="index-PAGER-1377"></a><a name="index-less-1378"></a><a name="index-more-1379"></a></p></blockquote></div>
12806
12807
<div class="defun">
12808
— Resource: <b>showNews</b> (<var>class ShowNews</var>)<var><a name="index-showNews-1380"></a></var><br>
12809
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, show the <acronym>DDD</acronym> news on standard output and
12810
exit. See <a href="#Options">Options</a>, for the <samp><span class="option">--news</span></samp> option.
12811
</p></blockquote></div>
12812
12813
<div class="defun">
12814
— Resource: <b>showVersion</b> (<var>class ShowVersion</var>)<var><a name="index-showVersion-1381"></a></var><br>
12815
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, show the <acronym>DDD</acronym> version on standard output and
12816
exit. See <a href="#Options">Options</a>, for the <samp><span class="option">--version</span></samp> option.
12817
</p></blockquote></div>
12818
12819
<div class="defun">
12820
— Resource: <b>suppressWarnings</b> (<var>class SuppressWarnings</var>)<var><a name="index-suppressWarnings-1382"></a></var><br>
12821
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, X warnings are suppressed. This is sometimes useful for
15538
12822
executables that were built on a machine with a different X or M*tif
15539
configuration. By default, this is <code>off</code>. See <a href="#X%20Warnings">X Warnings</a>, for
12823
configuration. By default, this is ‘<samp><span class="samp">off</span></samp>’. See <a href="#X-Warnings">X Warnings</a>, for
15540
12824
details.
15541
</td></tr>
15542
</table>
12825
</p></blockquote></div>
15543
12826
15544
<p>
15545
<table width="100%">
15546
<tr>
15547
<td align="left"><b>trace</b><i> </i>(<i>class Trace</i>)<i>
15548
</i></td>
15549
<td align="right">Resource</td>
15550
</tr>
15551
</table>
15552
<table width="95%" align="center">
15553
<tr><td>
15554
If <code>on</code>, show the dialog between <small>DDD</small> and the inferior debugger
15555
on standard output. Default is <code>off</code>. See <a href="#Options">Options</a>, for the
15556
<code>--trace</code> option.
15557
</td></tr>
15558
</table>
12827
<div class="defun">
12828
— Resource: <b>trace</b> (<var>class Trace</var>)<var><a name="index-trace-1383"></a></var><br>
12829
<blockquote><p>If ‘<samp><span class="samp">on</span></samp>’, show the dialog between <acronym>DDD</acronym> and the inferior debugger
12830
on standard output. Default is ‘<samp><span class="samp">off</span></samp>’. See <a href="#Options">Options</a>, for the
12831
<samp><span class="option">--trace</span></samp> option.
12832
</p></blockquote></div>
15559
12833
15560
12834
<div class="node">
15561
12835
<p><hr>
15562
<small class=header>
15563
Node:<a name="Configuration%20Notes">Configuration Notes</a>,
15564
Next:<a rel="next" accesskey="n" href="#Dirty%20Tricks">Dirty Tricks</a>,
15565
Previous:<a rel="previous" accesskey="p" href="#Bugs">Bugs</a>,
15566
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
12836
<a name="Configuration-Notes"></a>
12837
Next: <a rel="next" accesskey="n" href="#Dirty-Tricks">Dirty Tricks</a>,
12838
Previous: <a rel="previous" accesskey="p" href="#Bugs">Bugs</a>,
12839
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
15567
12840
</small>
15568
12841
15569
<br>
12842
15570
12843
</div>
15571
12844
15572
<h2 class="appendix">Configuration Notes</h2>
12845
<h2 class="appendix">Appendix C Configuration Notes</h2>
15573
12846
15574
12847
<ul class="menu">
15575
<li><a accesskey="1" href="#GDB">GDB</a>: Using <small>DDD</small> with <small>GDB</small>
15576
<li><a accesskey="2" href="#DBX">DBX</a>: Using <small>DDD</small> with <small>DBX</small>
15577
<li><a accesskey="3" href="#Ladebug">Ladebug</a>: Using <small>DDD</small> with Ladebug
15578
<li><a accesskey="4" href="#XDB">XDB</a>: Using <small>DDD</small> with <small>XDB</small>
15579
<li><a accesskey="5" href="#JDB">JDB</a>: Using <small>DDD</small> with <small>JDB</small>
15580
<li><a accesskey="6" href="#Perl">Perl</a>: Using <small>DDD</small> with Perl
15581
<li><a accesskey="7" href="#Bash">Bash</a>: Using <small>DDD</small> with Bash
15582
<li><a accesskey="8" href="#LessTif">LessTif</a>: Using <small>DDD</small> with LessTif
12848
<li><a accesskey="1" href="#GDB">GDB</a>: Using <acronym>DDD</acronym> with <acronym>GDB</acronym>
12849
<li><a accesskey="2" href="#Bash">Bash</a>: Using <acronym>DDD</acronym> with Bash
12850
<li><a accesskey="3" href="#DBX">DBX</a>: Using <acronym>DDD</acronym> with <acronym>DBX</acronym>
12851
<li><a accesskey="4" href="#Ladebug">Ladebug</a>: Using <acronym>DDD</acronym> with Ladebug
12852
<li><a accesskey="5" href="#JDB">JDB</a>: Using <acronym>DDD</acronym> with <acronym>JDB</acronym>
12853
<li><a accesskey="6" href="#Make">Make</a>: Using <acronym>DDD</acronym> with GNU Make
12854
<li><a accesskey="7" href="#Perl">Perl</a>: Using <acronym>DDD</acronym> with Perl
12855
<li><a accesskey="8" href="#Python">Python</a>: Using <acronym>DDD</acronym> with Python
12856
<li><a accesskey="9" href="#XDB">XDB</a>: Using <acronym>DDD</acronym> with <acronym>XDB</acronym>
12857
<li><a href="#LessTif">LessTif</a>: Using <acronym>DDD</acronym> with LessTif
15583
12858
</ul>
15584
12859
15585
12860
<div class="node">
15586
12861
<p><hr>
15587
<small class=header>
15588
Node:<a name="GDB">GDB</a>,
15589
Next:<a rel="next" accesskey="n" href="#DBX">DBX</a>,
15590
Up:<a rel="up" accesskey="u" href="#Configuration%20Notes">Configuration Notes</a>
12862
<a name="GDB"></a>
12863
Next: <a rel="next" accesskey="n" href="#Bash">Bash</a>,
12864
Up: <a rel="up" accesskey="u" href="#Configuration-Notes">Configuration Notes</a>
15591
12865
</small>
15592
12866
15593
<br>
12867
15594
12868
</div>
15595
12869
15596
<h3 class="section">Using DDD with GDB</h3>
12870
<h3 class="section">C.1 Using DDD with GDB</h3>
15597
12871
15598
<p>Some <small>GDB</small> settings are essential for <small>DDD</small> to work correctly.
12872
<p>Some <acronym>GDB</acronym> settings are essential for <acronym>DDD</acronym> to work correctly.
15599
12873
These settings with their correct values are:
15600
12874
<pre class="example"> set height 0
15601
12875
set width 0
15602
12876
set verbose off
15603
12877
set annotate 1
15604
12878
set prompt (gdb)
15605
</pre>
15606
15607
<p><small>DDD</small> sets these values automatically when invoking <small>GDB</small>; if these
12879
</pre>
12880
<p><acronym>DDD</acronym> sets these values automatically when invoking <acronym>GDB</acronym>; if these
15608
12881
values are changed, there may be some malfunctions, especially in the
15609
12882
data display.
15610
12883
15611
<p>When debugging at the machine level with <small>GDB</small> 4.12 and earlier as
15612
inferior debugger, use a <code>display /x $pc</code> command to ensure the
12884
<p>When debugging at the machine level with <acronym>GDB</acronym> 4.12 and earlier as
12885
inferior debugger, use a ‘<samp><span class="samp">display /x $pc</span></samp>’ command to ensure the
15613
12886
program counter value is updated correctly at each stop. You may also
15614
enter the command in <code>~/.gdbinit</code> or (better yet) upgrade to the
15615
most recent <small>GDB</small> version.
12887
enter the command in <samp><span class="file">~/.gdbinit</span></samp> or (better yet) upgrade to the
12888
most recent <acronym>GDB</acronym> version.
15616
12889
15617
12890
<ul class="menu">
15618
12891
<li><a accesskey="1" href="#WDB">WDB</a>: Using DDD with WDB
15619
<li><a accesskey="2" href="#WindRiver%20GDB">WindRiver GDB</a>: Using DDD with WindRiver GDB (Tornado)
12892
<li><a accesskey="2" href="#WindRiver-GDB">WindRiver GDB</a>: Using DDD with WindRiver GDB (Tornado)
15620
12893
</ul>
15621
12894
15622
12895
<div class="node">
15623
12896
<p><hr>
15624
<small class=header>
15625
Node:<a name="WDB">WDB</a>,
15626
Next:<a rel="next" accesskey="n" href="#WindRiver%20GDB">WindRiver GDB</a>,
15627
Up:<a rel="up" accesskey="u" href="#GDB">GDB</a>
12897
<a name="WDB"></a>
12898
Next: <a rel="next" accesskey="n" href="#WindRiver-GDB">WindRiver GDB</a>,
12899
Up: <a rel="up" accesskey="u" href="#GDB">GDB</a>
15628
12900
</small>
15629
12901
15630
<br>
12902
15631
12903
</div>
15632
12904
15633
<h4 class="subsection">Using DDD with WDB</h4>
15634
15635
<p>HP's WildeBeest (<small>WDB</small>) is essentially a variant of <small>GDB</small>. To start
15636
<small>DDD</small> with <small>WDB</small> as inferior debugger, use
15637
12905
<h4 class="subsection">C.1.1 Using DDD with WDB</h4>
12906
12907
<p><a name="index-WDB-1384"></a><a name="index-WildeBeest-1385"></a>
12908
HP's WildeBeest (<acronym>WDB</acronym>) is essentially a variant of <acronym>GDB</acronym>. To start
12909
<acronym>DDD</acronym> with <acronym>WDB</acronym> as inferior debugger, use
12910
12911
<p><a name="index-g_t_0040acronym_007bWDB_007d_002c-invoking-_0040DDD_007b_007d-with-1386"></a>
15638
12912
<pre class="example"> ddd --wdb <var>program</var>
15639
</pre>
15640
12913
</pre>
15641
12914
<p>See <a href="#GDB">GDB</a>, for further configuration notes.
15642
12915
15643
12916
<div class="node">
15644
12917
<p><hr>
15645
<small class=header>
15646
Node:<a name="WindRiver%20GDB">WindRiver GDB</a>,
15647
Previous:<a rel="previous" accesskey="p" href="#WDB">WDB</a>,
15648
Up:<a rel="up" accesskey="u" href="#GDB">GDB</a>
12918
<a name="WindRiver-GDB"></a>
12919
Previous: <a rel="previous" accesskey="p" href="#WDB">WDB</a>,
12920
Up: <a rel="up" accesskey="u" href="#GDB">GDB</a>
15649
12921
</small>
15650
12922
15651
<br>
12923
15652
12924
</div>
15653
12925
15654
<h4 class="subsection">Using DDD with WindRiver GDB (Tornado)</h4>
15655
15656
<p><small>DDD</small> now supports WindRiver's version of <small>GDB</small>.<a rel="footnote" href="#fn-34"><sup>34</sup></a>
15657
<small>DDD</small> can be integrated into the <code>Launch</code> window by placing the
15658
<code>launch.tcl</code> script (see below) into the the directory
15659
<code>~/.wind</code>.
15660
15661
<p>Currently, <small>DDD</small> only supports the PowerPC and has been only tested on
12926
<h4 class="subsection">C.1.2 Using DDD with WindRiver GDB (Tornado)</h4>
12927
12928
<p><a name="index-WindRiver-GDB-1387"></a><a name="index-Tornado-1388"></a>
12929
<acronym>DDD</acronym> now supports WindRiver's version of <acronym>GDB</acronym>.<a rel="footnote" href="#fn-34" name="fnd-34"><sup>34</sup></a>
12930
<acronym>DDD</acronym> can be integrated into the ‘<samp><span class="samp">Launch</span></samp>’ window by placing the
12931
<samp><span class="file">launch.tcl</span></samp> script (see below) into the the directory
12932
<samp><span class="file">~/.wind</span></samp>.
12933
12934
<p>Currently, <acronym>DDD</acronym> only supports the PowerPC and has been only tested on
15662
12935
a Solaris 2.6 host.
15663
12936
15664
<p><small>DDD</small> launches the version of <small>GDB</small> that is either in the current
12937
<p><acronym>DDD</acronym> launches the version of <acronym>GDB</acronym> that is either in the current
15665
12938
path, or the one specified on the command line using the
15666
<code>--debugger</code> command.
12939
‘<samp><span class="samp">--debugger</span></samp>’ command.
15667
12940
15668
12941
<p>Normally, the Tornado environment is set up by sourcing a script file
15669
12942
which, among other things, sets up the PATH variable.
15670
12943
15671
<p>It is suggested that a soft link for the version of <small>GDB</small> used for the
15672
target (i.e. <code>gdbppc</code>) be made in the same directory:
12944
<p>It is suggested that a soft link for the version of <acronym>GDB</acronym> used for the
12945
target (i.e. <samp><span class="file">gdbppc</span></samp>) be made in the same directory:
15673
12946
15674
12947
<pre class="example"> bin><kbd>ls -l gdb*</kbd>
15675
12948
39 Mar 6 16:14 gdb -> /usr/wind/host/sun4-solaris2/bin/gdbppc*
15676
12949
1619212 Mar 11 1997 gdbppc*
15677
12950
bin>_
15678
</pre>
15679
15680
<p>This way <small>DDD</small> will start the correct version of <small>GDB</small> automatically.
15681
15682
<p>It is also suggested that you use <small>DDD</small>'s execution window to
15683
facilitate parsing of <small>GDB</small> output. See <a href="#Debugger%20Communication">Debugger Communication</a>, for
12951
</pre>
12952
<p>This way <acronym>DDD</acronym> will start the correct version of <acronym>GDB</acronym> automatically.
12953
12954
<p>It is also suggested that you use <acronym>DDD</acronym>'s execution window to
12955
facilitate parsing of <acronym>GDB</acronym> output. See <a href="#Debugger-Communication">Debugger Communication</a>, for
15684
12956
details.
15685
12957
15686
12958
<p>Tornado reads the default TCL scripts first, then the ones in the users
15687
<code>.wind</code> directory. The following procedures can be cut and pasted into
15688
the user's <code>launch.tcl</code> file:
12959
<samp><span class="file">.wind</span></samp> directory. The following procedures can be cut and pasted into
12960
the user's <samp><span class="file">launch.tcl</span></samp> file:
15689
12961
15690
<pre class="smallexample"> # Launch.tcl - Launch application Tcl user customization file.
12962
<p class="noindent">
12963
<pre class="smallexample"> <p><table class="cartouche" summary="cartouche" border="1"><tr><td>
12964
# Launch.tcl - Launch application Tcl user customization file.
15691
12965
#
15692
12966
15693
12967
######
15710
12984
# Add to the default application bar
15711
12985
objectCreate app ddd DDD {launchDDD}
15712
12986
}
12987
</td></tr></table>
15713
12988
12989
<p><table class="cartouche" summary="cartouche" border="1"><tr><td>
15714
12990
######
15715
12991
#
15716
12992
# launchDDD - launch the DDD debugger
15752
13028
exec ddd --gdb --command=$startFileName &
15753
13029
}
15754
13030
}
13031
</td></tr></table>
15755
13032
13033
<p><table class="cartouche" summary="cartouche" border="1"><tr><td>
15756
13034
######
15757
13035
#
15758
13036
# Launch.tcl - Initialization
15762
13040
15763
13041
# Add DDD to the laucher
15764
13042
setupDDD
15765
</pre>
15766
15767
<p>In order for <small>DDD</small> to automatically display the source of a previously
15768
loaded file, the entry point must be named either <code>vxworks_main</code> or
15769
<code>main_vxworks</code>.
13043
</td></tr></table>
13044
</pre>
13045
<p>In order for <acronym>DDD</acronym> to automatically display the source of a previously
13046
loaded file, the entry point must be named either ‘<samp><span class="samp">vxworks_main</span></samp>’ or
13047
‘<samp><span class="samp">main_vxworks</span></samp>’.
15770
13048
15771
13049
<p>See <a href="#GDB">GDB</a>, for further configuration notes.
15772
13050
15773
13051
<div class="node">
15774
13052
<p><hr>
15775
<small class=header>
15776
Node:<a name="DBX">DBX</a>,
15777
Next:<a rel="next" accesskey="n" href="#Ladebug">Ladebug</a>,
15778
Previous:<a rel="previous" accesskey="p" href="#GDB">GDB</a>,
15779
Up:<a rel="up" accesskey="u" href="#Configuration%20Notes">Configuration Notes</a>
15780
</small>
15781
15782
<br>
15783
</div>
15784
15785
<h3 class="section">Using DDD with DBX</h3>
15786
15787
<p>When used for debugging Pascal-like programs, <small>DDD</small> does not
13053
<a name="Bash"></a>
13054
Next: <a rel="next" accesskey="n" href="#DBX">DBX</a>,
13055
Previous: <a rel="previous" accesskey="p" href="#GDB">GDB</a>,
13056
Up: <a rel="up" accesskey="u" href="#Configuration-Notes">Configuration Notes</a>
13057
</small>
13058
13059
13060
</div>
13061
13062
<h3 class="section">C.2 Using DDD with Bash</h3>
13063
13064
<p><acronym>BASH</acronym> support is rather new. As a programming language, <acronym>BASH</acronym> is
13065
not feature rich: there are no record structures or hash tables (yet),
13066
no pointers, package variable scoping or methods. So much of the data
13067
display and visualization features of DDD are disabled.
13068
13069
<p>As with any scripting or interpreted language like Perl, stepping
13070
a machine-language instructions (commands Stepi/Nexti) doesn't exist.
13071
13072
<p>Some <acronym>BASH</acronym> settings are essential for <acronym>DDD</acronym> to work correctly.
13073
These settings with their correct values are:
13074
13075
<pre class="example"> set annotate 1
13076
set prompt set prompt bashdb$_Dbg_less$_Dbg_greater$_Dbg_space
13077
</pre>
13078
<p><acronym>DDD</acronym> sets these values automatically when invoking <acronym>BASH</acronym>; if these
13079
values are changed, there may be some malfunctions.
13080
13081
<p>Pay special attention when the prompt has extra angle brackets (a
13082
nested shell) or has any parenthesis (is in a subshell). Quitting may
13083
merely exit out of one of these nested (sub)shells rather than leave
13084
the program.
13085
13086
<div class="node">
13087
<p><hr>
13088
<a name="DBX"></a>
13089
Next: <a rel="next" accesskey="n" href="#Ladebug">Ladebug</a>,
13090
Previous: <a rel="previous" accesskey="p" href="#Bash">Bash</a>,
13091
Up: <a rel="up" accesskey="u" href="#Configuration-Notes">Configuration Notes</a>
13092
</small>
13093
13094
13095
</div>
13096
13097
<h3 class="section">C.3 Using DDD with DBX</h3>
13098
13099
<p>When used for debugging Pascal-like programs, <acronym>DDD</acronym> does not
15788
13100
infer correct array subscripts and always starts to count with 1.
15789
13101
15790
<p>With some <small>DBX</small> versions (notably Solaris <small>DBX</small>),
15791
<small>DDD</small> strips C-style and C++-style comments from the
15792
<small>DBX</small> output in order to interpret it properly. This also
13102
<p>With some <acronym>DBX</acronym> versions (notably Solaris <acronym>DBX</acronym>),
13103
<acronym>DDD</acronym> strips C-style and C++-style comments from the
13104
<acronym>DBX</acronym> output in order to interpret it properly. This also
15793
13105
affects the output of the debugged program when sent to the debugger
15794
13106
console. Using the separate execution window avoids these problems.
15795
13107
15796
<p>In some <small>DBX</small> versions (notably DEC <small>DBX</small> and AIX <small>DBX</small>), there is no
15797
automatic data display. As an alternative, <small>DDD</small> uses the <small>DBX</small>
15798
<code>print</code> command to access data values. This means that variable
13108
<p>In some <acronym>DBX</acronym> versions (notably DEC <acronym>DBX</acronym> and AIX <acronym>DBX</acronym>), there is no
13109
automatic data display. As an alternative, <acronym>DDD</acronym> uses the <acronym>DBX</acronym>
13110
‘<samp><span class="samp">print</span></samp>’ command to access data values. This means that variable
15799
13111
names are interpreted according to the current frame; variables outside
15800
13112
the current frame cannot be displayed.
15801
13113
15802
13114
<div class="node">
15803
13115
<p><hr>
15804
<small class=header>
15805
Node:<a name="Ladebug">Ladebug</a>,
15806
Next:<a rel="next" accesskey="n" href="#XDB">XDB</a>,
15807
Previous:<a rel="previous" accesskey="p" href="#DBX">DBX</a>,
15808
Up:<a rel="up" accesskey="u" href="#Configuration%20Notes">Configuration Notes</a>
15809
</small>
15810
15811
<br>
15812
</div>
15813
15814
<h3 class="section">Using DDD with Ladebug</h3>
15815
15816
<p>All <small>DBX</small> limitations (see <a href="#DBX">DBX</a>) apply to Ladebug as well.
15817
15818
<div class="node">
15819
<p><hr>
15820
<small class=header>
15821
Node:<a name="XDB">XDB</a>,
15822
Next:<a rel="next" accesskey="n" href="#JDB">JDB</a>,
15823
Previous:<a rel="previous" accesskey="p" href="#Ladebug">Ladebug</a>,
15824
Up:<a rel="up" accesskey="u" href="#Configuration%20Notes">Configuration Notes</a>
15825
</small>
15826
15827
<br>
15828
</div>
15829
15830
<h3 class="section">Using DDD with XDB</h3>
15831
15832
<p>There is no automatic data display in <small>XDB</small>. As a workaround,
15833
<small>DDD</small> uses the <code>p</code> command to access data values. This
15834
means that variable names are interpreted according to the current
15835
frame; variables outside the current frame cannot be displayed.
15836
15837
<div class="node">
15838
<p><hr>
15839
<small class=header>
15840
Node:<a name="JDB">JDB</a>,
15841
Next:<a rel="next" accesskey="n" href="#Perl">Perl</a>,
15842
Previous:<a rel="previous" accesskey="p" href="#XDB">XDB</a>,
15843
Up:<a rel="up" accesskey="u" href="#Configuration%20Notes">Configuration Notes</a>
15844
</small>
15845
15846
<br>
15847
</div>
15848
15849
<h3 class="section">Using DDD with JDB</h3>
15850
15851
<p>There is no automatic data display in <small>JDB</small>. As a workaround,
15852
<small>DDD</small> uses the <code>dump</code> command to access data values.
13116
<a name="Ladebug"></a>
13117
Next: <a rel="next" accesskey="n" href="#JDB">JDB</a>,
13118
Previous: <a rel="previous" accesskey="p" href="#DBX">DBX</a>,
13119
Up: <a rel="up" accesskey="u" href="#Configuration-Notes">Configuration Notes</a>
13120
</small>
13121
13122
13123
</div>
13124
13125
<h3 class="section">C.4 Using DDD with Ladebug</h3>
13126
13127
<p>All <acronym>DBX</acronym> limitations (see <a href="#DBX">DBX</a>) apply to Ladebug as well.
13128
13129
<div class="node">
13130
<p><hr>
13131
<a name="JDB"></a>
13132
Next: <a rel="next" accesskey="n" href="#Make">Make</a>,
13133
Previous: <a rel="previous" accesskey="p" href="#Ladebug">Ladebug</a>,
13134
Up: <a rel="up" accesskey="u" href="#Configuration-Notes">Configuration Notes</a>
13135
</small>
13136
13137
13138
</div>
13139
13140
<h3 class="section">C.5 Using DDD with JDB</h3>
13141
13142
<p>There is no automatic data display in <acronym>JDB</acronym>. As a workaround,
13143
<acronym>DDD</acronym> uses the ‘<samp><span class="samp">dump</span></samp>’ command to access data values.
15853
13144
This means that variable names are interpreted according to the
15854
13145
current frame; variables outside the current frame cannot be
15855
13146
displayed.
15856
13147
15857
<p>In <small>JDB</small> 1.1, the <code>dump</code> and <code>print</code> commands do not support
13148
<p>In <acronym>JDB</acronym> 1.1, the ‘<samp><span class="samp">dump</span></samp>’ and ‘<samp><span class="samp">print</span></samp>’ commands do not support
15858
13149
expression evaluation. Hence, you cannot display arbitrary expressions.
15859
13150
15860
<p>Parsing of <small>JDB</small> output is quite CPU-intensive, due to the
13151
<p>Parsing of <acronym>JDB</acronym> output is quite CPU-intensive, due to the
15861
13152
recognition of asynchronous prompts (any thread may output anything at
15862
13153
any time, including prompts). Hence, a program producing much console
15863
output is likely to slow down <small>DDD</small> considerably. In such a
15864
case, have the program run with <code>-debug</code> in a separate window and
15865
attach <small>JDB</small> to it using the <code>-passwd</code> option.
15866
15867
<div class="node">
15868
<p><hr>
15869
<small class=header>
15870
Node:<a name="Perl">Perl</a>,
15871
Next:<a rel="next" accesskey="n" href="#Bash">Bash</a>,
15872
Previous:<a rel="previous" accesskey="p" href="#JDB">JDB</a>,
15873
Up:<a rel="up" accesskey="u" href="#Configuration%20Notes">Configuration Notes</a>
15874
</small>
15875
15876
<br>
15877
</div>
15878
15879
<h3 class="section">Using DDD with Perl</h3>
15880
15881
<p>There is no automatic data display in Perl. As a workaround,
15882
<small>DDD</small> uses the <code>x</code> command to access data values. This
15883
means that variable names are interpreted according to the current
15884
frame; variables outside the current frame cannot be displayed.
15885
15886
<div class="node">
15887
<p><hr>
15888
<small class=header>
15889
Node:<a name="Bash">Bash</a>,
15890
Next:<a rel="next" accesskey="n" href="#LessTif">LessTif</a>,
15891
Previous:<a rel="previous" accesskey="p" href="#Perl">Perl</a>,
15892
Up:<a rel="up" accesskey="u" href="#Configuration%20Notes">Configuration Notes</a>
15893
</small>
15894
15895
<br>
15896
</div>
15897
15898
<h3 class="section">Using DDD with Bash</h3>
15899
15900
<p><small>BASH</small> support is rather new. As a programming language, <small>BASH</small> is
15901
not feature rich: there are no record structures or hash tables (yet),
15902
no pointers, package variable scoping or methods. So much of the data
15903
display and visualization features of DDD are disabled.
13154
output is likely to slow down <acronym>DDD</acronym> considerably. In such a
13155
case, have the program run with <samp><span class="option">-debug</span></samp> in a separate window and
13156
attach <acronym>JDB</acronym> to it using the <samp><span class="option">-passwd</span></samp> option.
13157
13158
<div class="node">
13159
<p><hr>
13160
<a name="Make"></a>
13161
Next: <a rel="next" accesskey="n" href="#Perl">Perl</a>,
13162
Previous: <a rel="previous" accesskey="p" href="#JDB">JDB</a>,
13163
Up: <a rel="up" accesskey="u" href="#Configuration-Notes">Configuration Notes</a>
13164
</small>
13165
13166
13167
</div>
13168
13169
<h3 class="section">C.6 Using DDD with GNU Make</h3>
13170
13171
<p>GNU Make support is rather new. As a programming language, GNU Make is
13172
a bit of a stretch for DDD. There are no record structures or
13173
hash tables, no pointers. Well, actually this does exist, but the
13174
records, pointers and hash tables are fixed into the system. There
13175
are Makefile variables, “targets” (which sometimes refer to files),
13176
dependencies, and commands. There is sort of an “scope” that for
13177
variables too.
13178
13179
<p>But much of the data display and visualization features of DDD
13180
are disabled. However <code>info locals</code> does work and you can hover
13181
over a variable and see its value.
15904
13182
15905
13183
<p>As with any scripting or interpreted language like Perl, stepping
15906
13184
a machine-language instructions (commands Stepi/Nexti) doesn't exist.
15907
13185
15908
<p>Some <small>BASH</small> settings are essential for <small>DDD</small> to work correctly.
15909
These settings with their correct values are:
15910
15911
<pre class="example"> set annotate 1
15912
set prompt set prompt bashdb$_Dbg_less$_Dbg_greater$_Dbg_space
15913
</pre>
15914
15915
<p><small>DDD</small> sets these values automatically when invoking <small>BASH</small>; if these
15916
values are changed, there may be some malfunctions.
15917
15918
<p>Pay special attention when the prompt has extra angle brackets (a
15919
nested shell) or has any parenthesis (is in a subshell). Quitting may
15920
merely exit out of one of these nested (sub)shells rather than leave
15921
the program.
15922
15923
<div class="node">
15924
<p><hr>
15925
<small class=header>
15926
Node:<a name="LessTif">LessTif</a>,
15927
Previous:<a rel="previous" accesskey="p" href="#Bash">Bash</a>,
15928
Up:<a rel="up" accesskey="u" href="#Configuration%20Notes">Configuration Notes</a>
15929
</small>
15930
15931
<br>
15932
</div>
15933
15934
<h3 class="section">Using DDD with LessTif</h3>
15935
15936
<p><small>DDD</small> includes a number of hacks that make <small>DDD</small> run with
13186
<p>Pay special attention when the prompt has extra angle
13187
brackets—nested invocation of GNU MAKE. Quitting may merely exit out
13188
of one of these nested invocations rather than leave the program.
13189
13190
<div class="node">
13191
<p><hr>
13192
<a name="Perl"></a>
13193
Next: <a rel="next" accesskey="n" href="#Python">Python</a>,
13194
Previous: <a rel="previous" accesskey="p" href="#Make">Make</a>,
13195
Up: <a rel="up" accesskey="u" href="#Configuration-Notes">Configuration Notes</a>
13196
</small>
13197
13198
13199
</div>
13200
13201
<h3 class="section">C.7 Using DDD with Perl</h3>
13202
13203
<p>There is no automatic data display in Perl. As a workaround,
13204
<acronym>DDD</acronym> uses the ‘<samp><span class="samp">x</span></samp>’ command to access data values. This
13205
means that variable names are interpreted according to the current
13206
frame; variables outside the current frame cannot be displayed.
13207
13208
<div class="node">
13209
<p><hr>
13210
<a name="Python"></a>
13211
Next: <a rel="next" accesskey="n" href="#XDB">XDB</a>,
13212
Previous: <a rel="previous" accesskey="p" href="#Perl">Perl</a>,
13213
Up: <a rel="up" accesskey="u" href="#Configuration-Notes">Configuration Notes</a>
13214
</small>
13215
13216
13217
</div>
13218
13219
<h3 class="section">C.8 Using DDD with Python</h3>
13220
13221
<p>In short, make sure you use a newer version of <code>pydb</code>, one from
13222
<a href="http://bashdb.sourceforge.net/pydb">http://bashdb.sourceforge.net/pydb</a>. Older versions that had
13223
been supplied with <acronym>DDD</acronym> will no longer work.
13224
13225
<p>History: Up to around 1999 there was parallel development that went on
13226
between <acronym>DDD</acronym>'s Python debugger <code>pydb</code> and the stock python debugger
13227
<code>pdb</code>. These were not necessarily <em>competing</em> efforts, just
13228
parallel. In fact the same person worked a little bit on both.
13229
13230
<p>One feature that <code>pydb</code> supported that wasn't in <code>pdb</code> was <acronym>GDB</acronym>'s
13231
<code>display</code> command.
13232
13233
<p>After 1999, maintaining <code>pydb</code> more or less fell into disuse and <code>pdb</code>
13234
sort of inched ahead with bug fixes and redisigned interaces. Around
13235
the beginning of 2006, new work was started to enhance pdb and to make
13236
it more like <acronym>GDB</acronym>. Since <acronym>DDD</acronym> already understands a large set of
13237
<acronym>GDB</acronym> commands, many of these enhancements were immediately
13238
realizable by <acronym>DDD</acronym>. These things include command completion,
13239
restarting the debugger, and using set/show/info commands.
13240
13241
<p>With the blessing of the original author of <code>pydb</code>, the new effort
13242
took over the name of the old one, Although it did not actually start
13243
out from the <code>pydb</code> base but from pdb adding the old <code>pydb</code>
13244
features.
13245
13246
<div class="node">
13247
<p><hr>
13248
<a name="XDB"></a>
13249
Next: <a rel="next" accesskey="n" href="#LessTif">LessTif</a>,
13250
Previous: <a rel="previous" accesskey="p" href="#Python">Python</a>,
13251
Up: <a rel="up" accesskey="u" href="#Configuration-Notes">Configuration Notes</a>
13252
</small>
13253
13254
13255
</div>
13256
13257
<h3 class="section">C.9 Using DDD with XDB</h3>
13258
13259
<p>There is no automatic data display in <acronym>XDB</acronym>. As a workaround,
13260
<acronym>DDD</acronym> uses the ‘<samp><span class="samp">p</span></samp>’ command to access data values. This
13261
means that variable names are interpreted according to the current
13262
frame; variables outside the current frame cannot be displayed.
13263
13264
<div class="node">
13265
<p><hr>
13266
<a name="LessTif"></a>
13267
Previous: <a rel="previous" accesskey="p" href="#XDB">XDB</a>,
13268
Up: <a rel="up" accesskey="u" href="#Configuration-Notes">Configuration Notes</a>
13269
</small>
13270
13271
13272
</div>
13273
13274
<h3 class="section">C.10 Using DDD with LessTif</h3>
13275
13276
<p><acronym>DDD</acronym> includes a number of hacks that make <acronym>DDD</acronym> run with
15937
13277
<em>LessTif,</em> a free M*tif library without loss of functionality.
15938
Since a <small>DDD</small> binary may be dynamically bound and used with either an
13278
Since a <acronym>DDD</acronym> binary may be dynamically bound and used with either an
15939
13279
OSF/Motif or LessTif library, these <em>lesstif hacks</em> can be enabled
15940
13280
and disabled at run time.
15941
13281
15942
13282
<p>Whether the <em>lesstif hacks</em> are included at run-time depends on the
15943
setting of the <code>lessTifVersion</code> resource:
13283
setting of the ‘<samp><span class="samp">lessTifVersion</span></samp>’ resource:
15944
13284
15945
<p>
15946
<table width="100%">
15947
<tr>
15948
<td align="left"><b>lessTifVersion</b><i> </i>(<i>class LessTifVersion</i>)<i>
15949
</i></td>
15950
<td align="right">Resource</td>
15951
</tr>
15952
</table>
15953
<table width="95%" align="center">
15954
<tr><td>
15955
Indicates the LessTif version <small>DDD</small> is running against. For
13285
<div class="defun">
13286
— Resource: <b>lessTifVersion</b> (<var>class LessTifVersion</var>)<var><a name="index-lessTifVersion-1389"></a></var><br>
13287
<blockquote><p>Indicates the LessTif version <acronym>DDD</acronym> is running against. For
15956
13288
LessTif version <var>x.y</var>, the value is <var>x</var> multiplied by 1000 plus
15957
<var>y</var>--for instance, the value <code>79</code> stands for LessTif 0.79 and
13289
<var>y</var>—for instance, the value <code>79</code> stands for LessTif 0.79 and
15958
13290
the value <code>1005</code> stands for LessTif 1.5.
15959
13291
15960
<p>If the value of this resource is less than 1000, indicating LessTif
15961
0.99 or earlier, <small>DDD</small> enables version-specific hacks to make
15962
<small>DDD</small> work around LessTif bugs and deficiencies.
13292
<p>If the value of this resource is less than 1000, indicating LessTif
13293
0.99 or earlier, <acronym>DDD</acronym> enables version-specific hacks to make
13294
<acronym>DDD</acronym> work around LessTif bugs and deficiencies.
15963
13295
15964
<p>If <small>DDD</small> was compiled against LessTif, the default value is the
15965
value of the <code>LessTifVersion</code> macro in <code><Xm/Xm.h></code>. If
15966
<small>DDD</small> was compiled against OSF/Motif, the default value is
13296
<p>If <acronym>DDD</acronym> was compiled against LessTif, the default value is the
13297
value of the ‘<samp><span class="samp">LessTifVersion</span></samp>’ macro in <samp><span class="file"><Xm/Xm.h></span></samp>. If
13298
<acronym>DDD</acronym> was compiled against OSF/Motif, the default value is
15967
13299
<code>1000</code>, disabling all LessTif-specific hacks.
15968
</td></tr>
15969
</table>
13300
</p></blockquote></div>
15970
13301
15971
<p>To set the <code>lessTifVersion</code> resource at <small>DDD</small> invocation and
13302
<p>To set the ‘<samp><span class="samp">lessTifVersion</span></samp>’ resource at <acronym>DDD</acronym> invocation and
15972
13303
to specify the version number of the LessTif library, you can also use
15973
the option <code>--lesstif-version</code> <var>version</var>.
13304
the option <samp><span class="option">--lesstif-version</span></samp> <var>version</var>.
15974
13305
15975
<p>The default value of the <code>lessTifVersion</code> resource is derived from
15976
the LessTif library <small>DDD</small> was compiled against (or <code>1000</code>
13306
<p>The default value of the ‘<samp><span class="samp">lessTifVersion</span></samp>’ resource is derived from
13307
the LessTif library <acronym>DDD</acronym> was compiled against (or <code>1000</code>
15977
13308
when compiled against OSF/Motif). Hence, you normally don't need to
15978
13309
worry about the value of this resource. However, if you use a
15979
dynamically linked <small>DDD</small> binary with a library other than the one
15980
<small>DDD</small> was compiled against, you must specify the version number of
15981
the library using this resource. (Unfortunately, <small>DDD</small> cannot
13310
dynamically linked <acronym>DDD</acronym> binary with a library other than the one
13311
<acronym>DDD</acronym> was compiled against, you must specify the version number of
13312
the library using this resource. (Unfortunately, <acronym>DDD</acronym> cannot
15982
13313
detect this at run-time.)
15983
13314
15984
13315
<p>Here are a few scenarios to illustrate this scheme:
15985
13316
<ul>
15986
<li>Your <small>DDD</small> binary was compiled against OSF/Motif, but you use
15987
a LessTif 0.88 dynamic library instead. Invoke <small>DDD</small> with
15988
<code>--lesstif-version 88</code>.
15989
<li>Your <small>DDD</small> binary was compiled against LessTif, but you use
15990
a OSF/Motif dynamic library instead. Invoke <small>DDD</small> with
15991
<code>--lesstif-version 1000</code>.
15992
<li>Your <small>DDD</small> binary was compiled against LessTif 0.85, and you
15993
have upgraded to LessTif 0.90. Invoke <small>DDD</small> with
15994
<code>--lesstif-version 90</code>.
13317
<li>Your <acronym>DDD</acronym> binary was compiled against OSF/Motif, but you use
13318
a LessTif 0.88 dynamic library instead. Invoke <acronym>DDD</acronym> with
13319
<samp><span class="option">--lesstif-version 88</span></samp>.
13320
<li>Your <acronym>DDD</acronym> binary was compiled against LessTif, but you use
13321
a OSF/Motif dynamic library instead. Invoke <acronym>DDD</acronym> with
13322
<samp><span class="option">--lesstif-version 1000</span></samp>.
13323
<li>Your <acronym>DDD</acronym> binary was compiled against LessTif 0.85, and you
13324
have upgraded to LessTif 0.90. Invoke <acronym>DDD</acronym> with
13325
<samp><span class="option">--lesstif-version 90</span></samp>.
15995
13326
</ul>
15996
13327
15997
<p>To find out the LessTif or OSF/Motif version <small>DDD</small> was
15998
compiled against, invoke <small>DDD</small> with the
15999
<code>--configuration</code> option.
13328
<p>To find out the LessTif or OSF/Motif version <acronym>DDD</acronym> was
13329
compiled against, invoke <acronym>DDD</acronym> with the
13330
<samp><span class="option">--configuration</span></samp> option.
16000
13331
16001
<p>In the <small>DDD</small> source, LessTif-specific hacks are controlled by
16002
the string <code>lesstif_version</code>.
13332
<p>In the <acronym>DDD</acronym> source, LessTif-specific hacks are controlled by
13333
the string ‘<samp><span class="samp">lesstif_version</span></samp>’.
16003
13334
16004
13335
<div class="node">
16005
13336
<p><hr>
16006
<small class=header>
16007
Node:<a name="Dirty%20Tricks">Dirty Tricks</a>,
16008
Next:<a rel="next" accesskey="n" href="#Extending">Extending</a>,
16009
Previous:<a rel="previous" accesskey="p" href="#Configuration%20Notes">Configuration Notes</a>,
16010
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
13337
<a name="Dirty-Tricks"></a>
13338
Next: <a rel="next" accesskey="n" href="#Extending">Extending</a>,
13339
Previous: <a rel="previous" accesskey="p" href="#Configuration-Notes">Configuration Notes</a>,
13340
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
16011
13341
</small>
16012
13342
16013
<br>
13343
16014
13344
</div>
16015
13345
16016
<h2 class="appendix">Dirty Tricks</h2>
13346
<h2 class="appendix">Appendix D Dirty Tricks</h2>
16017
13347
16018
<p>Do you miss anything in this manual? Do you have any material that
13348
<p>Do you miss anything in this manual? Do you have any material that
16019
13349
should be added? Please send any contributions to <a href="mailto:ddd@gnu.org">ddd@gnu.org</a>.
16020
13350
16021
13351
<div class="node">
16022
13352
<p><hr>
16023
<small class=header>
16024
Node:<a name="Extending">Extending</a>,
16025
Next:<a rel="next" accesskey="n" href="#FAQ">FAQ</a>,
16026
Previous:<a rel="previous" accesskey="p" href="#Dirty%20Tricks">Dirty Tricks</a>,
16027
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
13353
<a name="Extending"></a>
13354
Next: <a rel="next" accesskey="n" href="#FAQ">FAQ</a>,
13355
Previous: <a rel="previous" accesskey="p" href="#Dirty-Tricks">Dirty Tricks</a>,
13356
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
16028
13357
</small>
16029
13358
16030
<br>
13359
16031
13360
</div>
16032
13361
16033
<h2 class="appendix">Extending DDD</h2>
13362
<h2 class="appendix">Appendix E Extending DDD</h2>
16034
13363
16035
<p>If you have any contributions to be incorporated into <small>DDD</small>,
13364
<p>If you have any contributions to be incorporated into <acronym>DDD</acronym>,
16036
13365
please send them to <a href="mailto:ddd@gnu.org">ddd@gnu.org</a>. For suggestions on what might
16037
be done, see the file <code>TODO</code> in the <small>DDD</small> distribution.
13366
be done, see the file ‘<samp><span class="samp">TODO</span></samp>’ in the <acronym>DDD</acronym> distribution.
16038
13367
16039
13368
<div class="node">
16040
13369
<p><hr>
16041
<small class=header>
16042
Node:<a name="FAQ">FAQ</a>,
16043
Next:<a rel="next" accesskey="n" href="#License">License</a>,
16044
Previous:<a rel="previous" accesskey="p" href="#Extending">Extending</a>,
16045
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
13370
<a name="FAQ"></a>
13371
Next: <a rel="next" accesskey="n" href="#License">License</a>,
13372
Previous: <a rel="previous" accesskey="p" href="#Extending">Extending</a>,
13373
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
16046
13374
</small>
16047
13375
16048
<br>
13376
16049
13377
</div>
16050
13378
16051
<h2 class="appendix">Frequently Answered Questions</h2>
13379
<h2 class="appendix">Appendix F Frequently Answered Questions</h2>
16052
13380
16053
<p>See <a href="http://www.gnu.org/software/ddd/">the <small>DDD</small> <small>WWW</small> page</a> for
13381
<p>See <a href="http://www.gnu.org/software/ddd/">the <acronym>DDD</acronym> <acronym>WWW</acronym> page</a> for
16054
13382
frequently answered questions not covered in this manual.
16055
13383
16056
13384
<div class="node">
16057
13385
<p><hr>
16058
<small class=header>
16059
Node:<a name="License">License</a>,
16060
Next:<a rel="next" accesskey="n" href="#Help%20and%20Assistance">Help and Assistance</a>,
16061
Previous:<a rel="previous" accesskey="p" href="#FAQ">FAQ</a>,
16062
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
13386
<a name="License"></a>
13387
Next: <a rel="next" accesskey="n" href="#Help-and-Assistance">Help and Assistance</a>,
13388
Previous: <a rel="previous" accesskey="p" href="#FAQ">FAQ</a>,
13389
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
16063
13390
</small>
16064
13391
16065
<br>
13392
16066
13393
</div>
16067
13394
16068
<h2 class="appendix">GNU General Public License</h2>
16069
16070
<div align="center">Version 2, June 1991</div>
16071
<pre class="display"> Copyright © 1989, 1991 Free Software Foundation, Inc. 675
16072
Mass Ave, Boston, MA 02111-1307, USA
13395
<h2 class="appendix">Appendix G GNU General Public License</h2>
13396
13397
<p><a name="index-License-1390"></a>
13398
13399
<!-- The GNU General Public License. -->
13400
<div align="center">Version 3, 29 June 2007</div>
13401
13402
<!-- This file is intended to be included within another document, -->
13403
<!-- hence no sectioning command or @node. -->
13404
<pre class="display"> Copyright © 2007 Free Software Foundation, Inc. <a href="http://fsf.org/">http://fsf.org/</a>
16073
13405
16074
Everyone is permitted to copy and distribute verbatim copies
16075
of this license document, but changing it is not allowed.
16076
</pre>
16077
16078
<h3 class="unnumberedsec">Preamble</h3>
16079
16080
<p>The licenses for most software are designed to take away your
16081
freedom to share and change it. By contrast, the GNU General Public
16082
License is intended to guarantee your freedom to share and change free
16083
software--to make sure the software is free for all its users. This
16084
General Public License applies to most of the Free Software
16085
Foundation's software and to any other program whose authors commit to
16086
using it. (Some other Free Software Foundation software is covered by
16087
the GNU Library General Public License instead.) You can apply it to
16088
your programs, too.
13406
Everyone is permitted to copy and distribute verbatim copies of this
13407
license document, but changing it is not allowed.
13408
</pre>
13409
<h3 class="heading">Preamble</h3>
13410
13411
<p>The GNU General Public License is a free, copyleft license for
13412
software and other kinds of works.
13413
13414
<p>The licenses for most software and other practical works are designed
13415
to take away your freedom to share and change the works. By contrast,
13416
the GNU General Public License is intended to guarantee your freedom
13417
to share and change all versions of a program—to make sure it remains
13418
free software for all its users. We, the Free Software Foundation,
13419
use the GNU General Public License for most of our software; it
13420
applies also to any other work released this way by its authors. You
13421
can apply it to your programs, too.
16089
13422
16090
13423
<p>When we speak of free software, we are referring to freedom, not
16091
13424
price. Our General Public Licenses are designed to make sure that you
16092
13425
have the freedom to distribute copies of free software (and charge for
16093
this service if you wish), that you receive source code or can get it
16094
if you want it, that you can change the software or use pieces of it
16095
in new free programs; and that you know you can do these things.
13426
them if you wish), that you receive source code or can get it if you
13427
want it, that you can change the software or use pieces of it in new
13428
free programs, and that you know you can do these things.
16096
13429
16097
<p>To protect your rights, we need to make restrictions that forbid
16098
anyone to deny you these rights or to ask you to surrender the rights.
16099
These restrictions translate to certain responsibilities for you if you
16100
distribute copies of the software, or if you modify it.
13430
<p>To protect your rights, we need to prevent others from denying you
13431
these rights or asking you to surrender the rights. Therefore, you
13432
have certain responsibilities if you distribute copies of the
13433
software, or if you modify it: responsibilities to respect the freedom
13434
of others.
16101
13435
16102
13436
<p>For example, if you distribute copies of such a program, whether
16103
gratis or for a fee, you must give the recipients all the rights that
16104
you have. You must make sure that they, too, receive or can get the
16105
source code. And you must show them these terms so they know their
16106
rights.
16107
16108
<p>We protect your rights with two steps: (1) copyright the software, and
16109
(2) offer you this license which gives you legal permission to copy,
16110
distribute and/or modify the software.
16111
16112
<p>Also, for each author's protection and ours, we want to make certain
16113
that everyone understands that there is no warranty for this free
16114
software. If the software is modified by someone else and passed on, we
16115
want its recipients to know that what they have is not the original, so
16116
that any problems introduced by others will not reflect on the original
16117
authors' reputations.
16118
16119
<p>Finally, any free program is threatened constantly by software
16120
patents. We wish to avoid the danger that redistributors of a free
16121
program will individually obtain patent licenses, in effect making the
16122
program proprietary. To prevent this, we have made it clear that any
16123
patent must be licensed for everyone's free use or not licensed at all.
13437
gratis or for a fee, you must pass on to the recipients the same
13438
freedoms that you received. You must make sure that they, too,
13439
receive or can get the source code. And you must show them these
13440
terms so they know their rights.
13441
13442
<p>Developers that use the GNU GPL protect your rights with two steps:
13443
(1) assert copyright on the software, and (2) offer you this License
13444
giving you legal permission to copy, distribute and/or modify it.
13445
13446
<p>For the developers' and authors' protection, the GPL clearly explains
13447
that there is no warranty for this free software. For both users' and
13448
authors' sake, the GPL requires that modified versions be marked as
13449
changed, so that their problems will not be attributed erroneously to
13450
authors of previous versions.
13451
13452
<p>Some devices are designed to deny users access to install or run
13453
modified versions of the software inside them, although the
13454
manufacturer can do so. This is fundamentally incompatible with the
13455
aim of protecting users' freedom to change the software. The
13456
systematic pattern of such abuse occurs in the area of products for
13457
individuals to use, which is precisely where it is most unacceptable.
13458
Therefore, we have designed this version of the GPL to prohibit the
13459
practice for those products. If such problems arise substantially in
13460
other domains, we stand ready to extend this provision to those
13461
domains in future versions of the GPL, as needed to protect the
13462
freedom of users.
13463
13464
<p>Finally, every program is threatened constantly by software patents.
13465
States should not allow patents to restrict development and use of
13466
software on general-purpose computers, but in those that do, we wish
13467
to avoid the special danger that patents applied to a free program
13468
could make it effectively proprietary. To prevent this, the GPL
13469
assures that patents cannot be used to render the program non-free.
16124
13470
16125
13471
<p>The precise terms and conditions for copying, distribution and
16126
13472
modification follow.
16127
13473
13474
<h3 class="heading">TERMS AND CONDITIONS</h3>
13475
16128
13476
<ol type=1 start=0>
16129
<li>This License applies to any program or other work which contains
16130
a notice placed by the copyright holder saying it may be distributed
16131
under the terms of this General Public License. The "Program", below,
16132
refers to any such program or work, and a "work based on the Program"
16133
means either the Program or any derivative work under copyright law:
16134
that is to say, a work containing the Program or a portion of it,
16135
either verbatim or with modifications and/or translated into another
16136
language. (Hereinafter, translation is included without limitation in
16137
the term "modification".) Each licensee is addressed as "you".
16138
16139
<p>Activities other than copying, distribution and modification are not
16140
covered by this License; they are outside its scope. The act of
16141
running the Program is not restricted, and the output from the Program
16142
is covered only if its contents constitute a work based on the
16143
Program (independent of having been made by running the Program).
16144
Whether that is true depends on what the Program does.
16145
16146
</p><li>You may copy and distribute verbatim copies of the Program's
16147
source code as you receive it, in any medium, provided that you
16148
conspicuously and appropriately publish on each copy an appropriate
16149
copyright notice and disclaimer of warranty; keep intact all the
16150
notices that refer to this License and to the absence of any warranty;
16151
and give any other recipients of the Program a copy of this License
16152
along with the Program.
16153
16154
<p>You may charge a fee for the physical act of transferring a copy, and
16155
you may at your option offer warranty protection in exchange for a fee.
16156
16157
</p><li>You may modify your copy or copies of the Program or any portion
16158
of it, thus forming a work based on the Program, and copy and
16159
distribute such modifications or work under the terms of Section 1
16160
above, provided that you also meet all of these conditions:
16161
16162
<ol type=a start=1>
16163
<li>You must cause the modified files to carry prominent notices
16164
stating that you changed the files and the date of any change.
16165
16166
<li>You must cause any work that you distribute or publish, that in
16167
whole or in part contains or is derived from the Program or any
16168
part thereof, to be licensed as a whole at no charge to all third
16169
parties under the terms of this License.
16170
16171
<li>If the modified program normally reads commands interactively
16172
when run, you must cause it, when started running for such
16173
interactive use in the most ordinary way, to print or display an
16174
announcement including an appropriate copyright notice and a
16175
notice that there is no warranty (or else, saying that you provide
16176
a warranty) and that users may redistribute the program under
16177
these conditions, and telling the user how to view a copy of this
16178
License. (Exception: if the Program itself is interactive but
16179
does not normally print such an announcement, your work based on
16180
the Program is not required to print an announcement.)
16181
</ol>
16182
16183
<p>These requirements apply to the modified work as a whole. If
16184
identifiable sections of that work are not derived from the Program,
16185
and can be reasonably considered independent and separate works in
16186
themselves, then this License, and its terms, do not apply to those
16187
sections when you distribute them as separate works. But when you
16188
distribute the same sections as part of a whole which is a work based
16189
on the Program, the distribution of the whole must be on the terms of
16190
this License, whose permissions for other licensees extend to the
16191
entire whole, and thus to each and every part regardless of who wrote it.
16192
16193
<p>Thus, it is not the intent of this section to claim rights or contest
16194
your rights to work written entirely by you; rather, the intent is to
16195
exercise the right to control the distribution of derivative or
16196
collective works based on the Program.
16197
16198
<p>In addition, mere aggregation of another work not based on the Program
16199
with the Program (or with a work based on the Program) on a volume of
16200
a storage or distribution medium does not bring the other work under
16201
the scope of this License.
16202
16203
</p><li>You may copy and distribute the Program (or a work based on it,
16204
under Section 2) in object code or executable form under the terms of
16205
Sections 1 and 2 above provided that you also do one of the following:
16206
16207
<ol type=a start=1>
16208
<li>Accompany it with the complete corresponding machine-readable
16209
source code, which must be distributed under the terms of Sections
16210
1 and 2 above on a medium customarily used for software interchange; or,
16211
16212
<li>Accompany it with a written offer, valid for at least three
16213
years, to give any third party, for a charge no more than your
16214
cost of physically performing source distribution, a complete
16215
machine-readable copy of the corresponding source code, to be
16216
distributed under the terms of Sections 1 and 2 above on a medium
16217
customarily used for software interchange; or,
16218
16219
<li>Accompany it with the information you received as to the offer
16220
to distribute corresponding source code. (This alternative is
16221
allowed only for noncommercial distribution and only if you
16222
received the program in object code or executable form with such
16223
an offer, in accord with Subsection b above.)
16224
</ol>
16225
16226
<p>The source code for a work means the preferred form of the work for
16227
making modifications to it. For an executable work, complete source
16228
code means all the source code for all modules it contains, plus any
16229
associated interface definition files, plus the scripts used to
16230
control compilation and installation of the executable. However, as a
16231
special exception, the source code distributed need not include
16232
anything that is normally distributed (in either source or binary
16233
form) with the major components (compiler, kernel, and so on) of the
16234
operating system on which the executable runs, unless that component
16235
itself accompanies the executable.
16236
16237
<p>If distribution of executable or object code is made by offering
16238
access to copy from a designated place, then offering equivalent
16239
access to copy the source code from the same place counts as
16240
distribution of the source code, even though third parties are not
16241
compelled to copy the source along with the object code.
16242
16243
</p><li>You may not copy, modify, sublicense, or distribute the Program
16244
except as expressly provided under this License. Any attempt
16245
otherwise to copy, modify, sublicense or distribute the Program is
16246
void, and will automatically terminate your rights under this License.
16247
However, parties who have received copies, or rights, from you under
16248
this License will not have their licenses terminated so long as such
16249
parties remain in full compliance.
16250
16251
<li>You are not required to accept this License, since you have not
16252
signed it. However, nothing else grants you permission to modify or
16253
distribute the Program or its derivative works. These actions are
16254
prohibited by law if you do not accept this License. Therefore, by
16255
modifying or distributing the Program (or any work based on the
16256
Program), you indicate your acceptance of this License to do so, and
16257
all its terms and conditions for copying, distributing or modifying
16258
the Program or works based on it.
16259
16260
<li>Each time you redistribute the Program (or any work based on the
16261
Program), the recipient automatically receives a license from the
16262
original licensor to copy, distribute or modify the Program subject to
16263
these terms and conditions. You may not impose any further
16264
restrictions on the recipients' exercise of the rights granted herein.
16265
You are not responsible for enforcing compliance by third parties to
13477
<li>Definitions.
13478
13479
<p>“This License” refers to version 3 of the GNU General Public License.
13480
13481
<p>“Copyright” also means copyright-like laws that apply to other kinds
13482
of works, such as semiconductor masks.
13483
13484
<p>“The Program” refers to any copyrightable work licensed under this
13485
License. Each licensee is addressed as “you”. “Licensees” and
13486
“recipients” may be individuals or organizations.
13487
13488
<p>To “modify” a work means to copy from or adapt all or part of the work
13489
in a fashion requiring copyright permission, other than the making of
13490
an exact copy. The resulting work is called a “modified version” of
13491
the earlier work or a work “based on” the earlier work.
13492
13493
<p>A “covered work” means either the unmodified Program or a work based
13494
on the Program.
13495
13496
<p>To “propagate” a work means to do anything with it that, without
13497
permission, would make you directly or secondarily liable for
13498
infringement under applicable copyright law, except executing it on a
13499
computer or modifying a private copy. Propagation includes copying,
13500
distribution (with or without modification), making available to the
13501
public, and in some countries other activities as well.
13502
13503
<p>To “convey” a work means any kind of propagation that enables other
13504
parties to make or receive copies. Mere interaction with a user
13505
through a computer network, with no transfer of a copy, is not
13506
conveying.
13507
13508
<p>An interactive user interface displays “Appropriate Legal Notices” to
13509
the extent that it includes a convenient and prominently visible
13510
feature that (1) displays an appropriate copyright notice, and (2)
13511
tells the user that there is no warranty for the work (except to the
13512
extent that warranties are provided), that licensees may convey the
13513
work under this License, and how to view a copy of this License. If
13514
the interface presents a list of user commands or options, such as a
13515
menu, a prominent item in the list meets this criterion.
13516
13517
<li>Source Code.
13518
13519
<p>The “source code” for a work means the preferred form of the work for
13520
making modifications to it. “Object code” means any non-source form
13521
of a work.
13522
13523
<p>A “Standard Interface” means an interface that either is an official
13524
standard defined by a recognized standards body, or, in the case of
13525
interfaces specified for a particular programming language, one that
13526
is widely used among developers working in that language.
13527
13528
<p>The “System Libraries” of an executable work include anything, other
13529
than the work as a whole, that (a) is included in the normal form of
13530
packaging a Major Component, but which is not part of that Major
13531
Component, and (b) serves only to enable use of the work with that
13532
Major Component, or to implement a Standard Interface for which an
13533
implementation is available to the public in source code form. A
13534
“Major Component”, in this context, means a major essential component
13535
(kernel, window system, and so on) of the specific operating system
13536
(if any) on which the executable work runs, or a compiler used to
13537
produce the work, or an object code interpreter used to run it.
13538
13539
<p>The “Corresponding Source” for a work in object code form means all
13540
the source code needed to generate, install, and (for an executable
13541
work) run the object code and to modify the work, including scripts to
13542
control those activities. However, it does not include the work's
13543
System Libraries, or general-purpose tools or generally available free
13544
programs which are used unmodified in performing those activities but
13545
which are not part of the work. For example, Corresponding Source
13546
includes interface definition files associated with source files for
13547
the work, and the source code for shared libraries and dynamically
13548
linked subprograms that the work is specifically designed to require,
13549
such as by intimate data communication or control flow between those
13550
subprograms and other parts of the work.
13551
13552
<p>The Corresponding Source need not include anything that users can
13553
regenerate automatically from other parts of the Corresponding Source.
13554
13555
<p>The Corresponding Source for a work in source code form is that same
13556
work.
13557
13558
<li>Basic Permissions.
13559
13560
<p>All rights granted under this License are granted for the term of
13561
copyright on the Program, and are irrevocable provided the stated
13562
conditions are met. This License explicitly affirms your unlimited
13563
permission to run the unmodified Program. The output from running a
13564
covered work is covered by this License only if the output, given its
13565
content, constitutes a covered work. This License acknowledges your
13566
rights of fair use or other equivalent, as provided by copyright law.
13567
13568
<p>You may make, run and propagate covered works that you do not convey,
13569
without conditions so long as your license otherwise remains in force.
13570
You may convey covered works to others for the sole purpose of having
13571
them make modifications exclusively for you, or provide you with
13572
facilities for running those works, provided that you comply with the
13573
terms of this License in conveying all material for which you do not
13574
control copyright. Those thus making or running the covered works for
13575
you must do so exclusively on your behalf, under your direction and
13576
control, on terms that prohibit them from making any copies of your
13577
copyrighted material outside their relationship with you.
13578
13579
<p>Conveying under any other circumstances is permitted solely under the
13580
conditions stated below. Sublicensing is not allowed; section 10
13581
makes it unnecessary.
13582
13583
<li>Protecting Users' Legal Rights From Anti-Circumvention Law.
13584
13585
<p>No covered work shall be deemed part of an effective technological
13586
measure under any applicable law fulfilling obligations under article
13587
11 of the WIPO copyright treaty adopted on 20 December 1996, or
13588
similar laws prohibiting or restricting circumvention of such
13589
measures.
13590
13591
<p>When you convey a covered work, you waive any legal power to forbid
13592
circumvention of technological measures to the extent such
13593
circumvention is effected by exercising rights under this License with
13594
respect to the covered work, and you disclaim any intention to limit
13595
operation or modification of the work as a means of enforcing, against
13596
the work's users, your or third parties' legal rights to forbid
13597
circumvention of technological measures.
13598
13599
<li>Conveying Verbatim Copies.
13600
13601
<p>You may convey verbatim copies of the Program's source code as you
13602
receive it, in any medium, provided that you conspicuously and
13603
appropriately publish on each copy an appropriate copyright notice;
13604
keep intact all notices stating that this License and any
13605
non-permissive terms added in accord with section 7 apply to the code;
13606
keep intact all notices of the absence of any warranty; and give all
13607
recipients a copy of this License along with the Program.
13608
13609
<p>You may charge any price or no price for each copy that you convey,
13610
and you may offer support or warranty protection for a fee.
13611
13612
<li>Conveying Modified Source Versions.
13613
13614
<p>You may convey a work based on the Program, or the modifications to
13615
produce it from the Program, in the form of source code under the
13616
terms of section 4, provided that you also meet all of these
13617
conditions:
13618
13619
<ol type=a start=1>
13620
<li>The work must carry prominent notices stating that you modified it,
13621
and giving a relevant date.
13622
13623
<li>The work must carry prominent notices stating that it is released
13624
under this License and any conditions added under section 7. This
13625
requirement modifies the requirement in section 4 to “keep intact all
13626
notices”.
13627
13628
<li>You must license the entire work, as a whole, under this License to
13629
anyone who comes into possession of a copy. This License will
13630
therefore apply, along with any applicable section 7 additional terms,
13631
to the whole of the work, and all its parts, regardless of how they
13632
are packaged. This License gives no permission to license the work in
13633
any other way, but it does not invalidate such permission if you have
13634
separately received it.
13635
13636
<li>If the work has interactive user interfaces, each must display
13637
Appropriate Legal Notices; however, if the Program has interactive
13638
interfaces that do not display Appropriate Legal Notices, your work
13639
need not make them do so.
13640
</ol>
13641
13642
<p>A compilation of a covered work with other separate and independent
13643
works, which are not by their nature extensions of the covered work,
13644
and which are not combined with it such as to form a larger program,
13645
in or on a volume of a storage or distribution medium, is called an
13646
“aggregate” if the compilation and its resulting copyright are not
13647
used to limit the access or legal rights of the compilation's users
13648
beyond what the individual works permit. Inclusion of a covered work
13649
in an aggregate does not cause this License to apply to the other
13650
parts of the aggregate.
13651
13652
<li>Conveying Non-Source Forms.
13653
13654
<p>You may convey a covered work in object code form under the terms of
13655
sections 4 and 5, provided that you also convey the machine-readable
13656
Corresponding Source under the terms of this License, in one of these
13657
ways:
13658
13659
<ol type=a start=1>
13660
<li>Convey the object code in, or embodied in, a physical product
13661
(including a physical distribution medium), accompanied by the
13662
Corresponding Source fixed on a durable physical medium customarily
13663
used for software interchange.
13664
13665
<li>Convey the object code in, or embodied in, a physical product
13666
(including a physical distribution medium), accompanied by a written
13667
offer, valid for at least three years and valid for as long as you
13668
offer spare parts or customer support for that product model, to give
13669
anyone who possesses the object code either (1) a copy of the
13670
Corresponding Source for all the software in the product that is
13671
covered by this License, on a durable physical medium customarily used
13672
for software interchange, for a price no more than your reasonable
13673
cost of physically performing this conveying of source, or (2) access
13674
to copy the Corresponding Source from a network server at no charge.
13675
13676
<li>Convey individual copies of the object code with a copy of the written
13677
offer to provide the Corresponding Source. This alternative is
13678
allowed only occasionally and noncommercially, and only if you
13679
received the object code with such an offer, in accord with subsection
13680
6b.
13681
13682
<li>Convey the object code by offering access from a designated place
13683
(gratis or for a charge), and offer equivalent access to the
13684
Corresponding Source in the same way through the same place at no
13685
further charge. You need not require recipients to copy the
13686
Corresponding Source along with the object code. If the place to copy
13687
the object code is a network server, the Corresponding Source may be
13688
on a different server (operated by you or a third party) that supports
13689
equivalent copying facilities, provided you maintain clear directions
13690
next to the object code saying where to find the Corresponding Source.
13691
Regardless of what server hosts the Corresponding Source, you remain
13692
obligated to ensure that it is available for as long as needed to
13693
satisfy these requirements.
13694
13695
<li>Convey the object code using peer-to-peer transmission, provided you
13696
inform other peers where the object code and Corresponding Source of
13697
the work are being offered to the general public at no charge under
13698
subsection 6d.
13699
13700
</ol>
13701
13702
<p>A separable portion of the object code, whose source code is excluded
13703
from the Corresponding Source as a System Library, need not be
13704
included in conveying the object code work.
13705
13706
<p>A “User Product” is either (1) a “consumer product”, which means any
13707
tangible personal property which is normally used for personal,
13708
family, or household purposes, or (2) anything designed or sold for
13709
incorporation into a dwelling. In determining whether a product is a
13710
consumer product, doubtful cases shall be resolved in favor of
13711
coverage. For a particular product received by a particular user,
13712
“normally used” refers to a typical or common use of that class of
13713
product, regardless of the status of the particular user or of the way
13714
in which the particular user actually uses, or expects or is expected
13715
to use, the product. A product is a consumer product regardless of
13716
whether the product has substantial commercial, industrial or
13717
non-consumer uses, unless such uses represent the only significant
13718
mode of use of the product.
13719
13720
<p>“Installation Information” for a User Product means any methods,
13721
procedures, authorization keys, or other information required to
13722
install and execute modified versions of a covered work in that User
13723
Product from a modified version of its Corresponding Source. The
13724
information must suffice to ensure that the continued functioning of
13725
the modified object code is in no case prevented or interfered with
13726
solely because modification has been made.
13727
13728
<p>If you convey an object code work under this section in, or with, or
13729
specifically for use in, a User Product, and the conveying occurs as
13730
part of a transaction in which the right of possession and use of the
13731
User Product is transferred to the recipient in perpetuity or for a
13732
fixed term (regardless of how the transaction is characterized), the
13733
Corresponding Source conveyed under this section must be accompanied
13734
by the Installation Information. But this requirement does not apply
13735
if neither you nor any third party retains the ability to install
13736
modified object code on the User Product (for example, the work has
13737
been installed in ROM).
13738
13739
<p>The requirement to provide Installation Information does not include a
13740
requirement to continue to provide support service, warranty, or
13741
updates for a work that has been modified or installed by the
13742
recipient, or for the User Product in which it has been modified or
13743
installed. Access to a network may be denied when the modification
13744
itself materially and adversely affects the operation of the network
13745
or violates the rules and protocols for communication across the
13746
network.
13747
13748
<p>Corresponding Source conveyed, and Installation Information provided,
13749
in accord with this section must be in a format that is publicly
13750
documented (and with an implementation available to the public in
13751
source code form), and must require no special password or key for
13752
unpacking, reading or copying.
13753
13754
<li>Additional Terms.
13755
13756
<p>“Additional permissions” are terms that supplement the terms of this
13757
License by making exceptions from one or more of its conditions.
13758
Additional permissions that are applicable to the entire Program shall
13759
be treated as though they were included in this License, to the extent
13760
that they are valid under applicable law. If additional permissions
13761
apply only to part of the Program, that part may be used separately
13762
under those permissions, but the entire Program remains governed by
13763
this License without regard to the additional permissions.
13764
13765
<p>When you convey a copy of a covered work, you may at your option
13766
remove any additional permissions from that copy, or from any part of
13767
it. (Additional permissions may be written to require their own
13768
removal in certain cases when you modify the work.) You may place
13769
additional permissions on material, added by you to a covered work,
13770
for which you have or can give appropriate copyright permission.
13771
13772
<p>Notwithstanding any other provision of this License, for material you
13773
add to a covered work, you may (if authorized by the copyright holders
13774
of that material) supplement the terms of this License with terms:
13775
13776
<ol type=a start=1>
13777
<li>Disclaiming warranty or limiting liability differently from the terms
13778
of sections 15 and 16 of this License; or
13779
13780
<li>Requiring preservation of specified reasonable legal notices or author
13781
attributions in that material or in the Appropriate Legal Notices
13782
displayed by works containing it; or
13783
13784
<li>Prohibiting misrepresentation of the origin of that material, or
13785
requiring that modified versions of such material be marked in
13786
reasonable ways as different from the original version; or
13787
13788
<li>Limiting the use for publicity purposes of names of licensors or
13789
authors of the material; or
13790
13791
<li>Declining to grant rights under trademark law for use of some trade
13792
names, trademarks, or service marks; or
13793
13794
<li>Requiring indemnification of licensors and authors of that material by
13795
anyone who conveys the material (or modified versions of it) with
13796
contractual assumptions of liability to the recipient, for any
13797
liability that these contractual assumptions directly impose on those
13798
licensors and authors.
13799
</ol>
13800
13801
<p>All other non-permissive additional terms are considered “further
13802
restrictions” within the meaning of section 10. If the Program as you
13803
received it, or any part of it, contains a notice stating that it is
13804
governed by this License along with a term that is a further
13805
restriction, you may remove that term. If a license document contains
13806
a further restriction but permits relicensing or conveying under this
13807
License, you may add to a covered work material governed by the terms
13808
of that license document, provided that the further restriction does
13809
not survive such relicensing or conveying.
13810
13811
<p>If you add terms to a covered work in accord with this section, you
13812
must place, in the relevant source files, a statement of the
13813
additional terms that apply to those files, or a notice indicating
13814
where to find the applicable terms.
13815
13816
<p>Additional terms, permissive or non-permissive, may be stated in the
13817
form of a separately written license, or stated as exceptions; the
13818
above requirements apply either way.
13819
13820
<li>Termination.
13821
13822
<p>You may not propagate or modify a covered work except as expressly
13823
provided under this License. Any attempt otherwise to propagate or
13824
modify it is void, and will automatically terminate your rights under
13825
this License (including any patent licenses granted under the third
13826
paragraph of section 11).
13827
13828
<p>However, if you cease all violation of this License, then your license
13829
from a particular copyright holder is reinstated (a) provisionally,
13830
unless and until the copyright holder explicitly and finally
13831
terminates your license, and (b) permanently, if the copyright holder
13832
fails to notify you of the violation by some reasonable means prior to
13833
60 days after the cessation.
13834
13835
<p>Moreover, your license from a particular copyright holder is
13836
reinstated permanently if the copyright holder notifies you of the
13837
violation by some reasonable means, this is the first time you have
13838
received notice of violation of this License (for any work) from that
13839
copyright holder, and you cure the violation prior to 30 days after
13840
your receipt of the notice.
13841
13842
<p>Termination of your rights under this section does not terminate the
13843
licenses of parties who have received copies or rights from you under
13844
this License. If your rights have been terminated and not permanently
13845
reinstated, you do not qualify to receive new licenses for the same
13846
material under section 10.
13847
13848
<li>Acceptance Not Required for Having Copies.
13849
13850
<p>You are not required to accept this License in order to receive or run
13851
a copy of the Program. Ancillary propagation of a covered work
13852
occurring solely as a consequence of using peer-to-peer transmission
13853
to receive a copy likewise does not require acceptance. However,
13854
nothing other than this License grants you permission to propagate or
13855
modify any covered work. These actions infringe copyright if you do
13856
not accept this License. Therefore, by modifying or propagating a
13857
covered work, you indicate your acceptance of this License to do so.
13858
13859
<li>Automatic Licensing of Downstream Recipients.
13860
13861
<p>Each time you convey a covered work, the recipient automatically
13862
receives a license from the original licensors, to run, modify and
13863
propagate that work, subject to this License. You are not responsible
13864
for enforcing compliance by third parties with this License.
13865
13866
<p>An “entity transaction” is a transaction transferring control of an
13867
organization, or substantially all assets of one, or subdividing an
13868
organization, or merging organizations. If propagation of a covered
13869
work results from an entity transaction, each party to that
13870
transaction who receives a copy of the work also receives whatever
13871
licenses to the work the party's predecessor in interest had or could
13872
give under the previous paragraph, plus a right to possession of the
13873
Corresponding Source of the work from the predecessor in interest, if
13874
the predecessor has it or can get it with reasonable efforts.
13875
13876
<p>You may not impose any further restrictions on the exercise of the
13877
rights granted or affirmed under this License. For example, you may
13878
not impose a license fee, royalty, or other charge for exercise of
13879
rights granted under this License, and you may not initiate litigation
13880
(including a cross-claim or counterclaim in a lawsuit) alleging that
13881
any patent claim is infringed by making, using, selling, offering for
13882
sale, or importing the Program or any portion of it.
13883
13884
<li>Patents.
13885
13886
<p>A “contributor” is a copyright holder who authorizes use under this
13887
License of the Program or a work on which the Program is based. The
13888
work thus licensed is called the contributor's “contributor version”.
13889
13890
<p>A contributor's “essential patent claims” are all patent claims owned
13891
or controlled by the contributor, whether already acquired or
13892
hereafter acquired, that would be infringed by some manner, permitted
13893
by this License, of making, using, or selling its contributor version,
13894
but do not include claims that would be infringed only as a
13895
consequence of further modification of the contributor version. For
13896
purposes of this definition, “control” includes the right to grant
13897
patent sublicenses in a manner consistent with the requirements of
16266
13898
this License.
16267
13899
16268
<li>If, as a consequence of a court judgment or allegation of patent
16269
infringement or for any other reason (not limited to patent issues),
16270
conditions are imposed on you (whether by court order, agreement or
13900
<p>Each contributor grants you a non-exclusive, worldwide, royalty-free
13901
patent license under the contributor's essential patent claims, to
13902
make, use, sell, offer for sale, import and otherwise run, modify and
13903
propagate the contents of its contributor version.
13904
13905
<p>In the following three paragraphs, a “patent license” is any express
13906
agreement or commitment, however denominated, not to enforce a patent
13907
(such as an express permission to practice a patent or covenant not to
13908
sue for patent infringement). To “grant” such a patent license to a
13909
party means to make such an agreement or commitment not to enforce a
13910
patent against the party.
13911
13912
<p>If you convey a covered work, knowingly relying on a patent license,
13913
and the Corresponding Source of the work is not available for anyone
13914
to copy, free of charge and under the terms of this License, through a
13915
publicly available network server or other readily accessible means,
13916
then you must either (1) cause the Corresponding Source to be so
13917
available, or (2) arrange to deprive yourself of the benefit of the
13918
patent license for this particular work, or (3) arrange, in a manner
13919
consistent with the requirements of this License, to extend the patent
13920
license to downstream recipients. “Knowingly relying” means you have
13921
actual knowledge that, but for the patent license, your conveying the
13922
covered work in a country, or your recipient's use of the covered work
13923
in a country, would infringe one or more identifiable patents in that
13924
country that you have reason to believe are valid.
13925
13926
<p>If, pursuant to or in connection with a single transaction or
13927
arrangement, you convey, or propagate by procuring conveyance of, a
13928
covered work, and grant a patent license to some of the parties
13929
receiving the covered work authorizing them to use, propagate, modify
13930
or convey a specific copy of the covered work, then the patent license
13931
you grant is automatically extended to all recipients of the covered
13932
work and works based on it.
13933
13934
<p>A patent license is “discriminatory” if it does not include within the
13935
scope of its coverage, prohibits the exercise of, or is conditioned on
13936
the non-exercise of one or more of the rights that are specifically
13937
granted under this License. You may not convey a covered work if you
13938
are a party to an arrangement with a third party that is in the
13939
business of distributing software, under which you make payment to the
13940
third party based on the extent of your activity of conveying the
13941
work, and under which the third party grants, to any of the parties
13942
who would receive the covered work from you, a discriminatory patent
13943
license (a) in connection with copies of the covered work conveyed by
13944
you (or copies made from those copies), or (b) primarily for and in
13945
connection with specific products or compilations that contain the
13946
covered work, unless you entered into that arrangement, or that patent
13947
license was granted, prior to 28 March 2007.
13948
13949
<p>Nothing in this License shall be construed as excluding or limiting
13950
any implied license or other defenses to infringement that may
13951
otherwise be available to you under applicable patent law.
13952
13953
<li>No Surrender of Others' Freedom.
13954
13955
<p>If conditions are imposed on you (whether by court order, agreement or
16271
13956
otherwise) that contradict the conditions of this License, they do not
16272
excuse you from the conditions of this License. If you cannot
16273
distribute so as to satisfy simultaneously your obligations under this
16274
License and any other pertinent obligations, then as a consequence you
16275
may not distribute the Program at all. For example, if a patent
16276
license would not permit royalty-free redistribution of the Program by
16277
all those who receive copies directly or indirectly through you, then
16278
the only way you could satisfy both it and this License would be to
16279
refrain entirely from distribution of the Program.
16280
16281
<p>If any portion of this section is held invalid or unenforceable under
16282
any particular circumstance, the balance of the section is intended to
16283
apply and the section as a whole is intended to apply in other
16284
circumstances.
16285
16286
<p>It is not the purpose of this section to induce you to infringe any
16287
patents or other property right claims or to contest validity of any
16288
such claims; this section has the sole purpose of protecting the
16289
integrity of the free software distribution system, which is
16290
implemented by public license practices. Many people have made
16291
generous contributions to the wide range of software distributed
16292
through that system in reliance on consistent application of that
16293
system; it is up to the author/donor to decide if he or she is willing
16294
to distribute software through any other system and a licensee cannot
16295
impose that choice.
16296
16297
<p>This section is intended to make thoroughly clear what is believed to
16298
be a consequence of the rest of this License.
16299
16300
</p><li>If the distribution and/or use of the Program is restricted in
16301
certain countries either by patents or by copyrighted interfaces, the
16302
original copyright holder who places the Program under this License
16303
may add an explicit geographical distribution limitation excluding
16304
those countries, so that distribution is permitted only in or among
16305
countries not thus excluded. In such case, this License incorporates
16306
the limitation as if written in the body of this License.
16307
16308
<li>The Free Software Foundation may publish revised and/or new versions
16309
of the General Public License from time to time. Such new versions will
16310
be similar in spirit to the present version, but may differ in detail to
16311
address new problems or concerns.
13957
excuse you from the conditions of this License. If you cannot convey
13958
a covered work so as to satisfy simultaneously your obligations under
13959
this License and any other pertinent obligations, then as a
13960
consequence you may not convey it at all. For example, if you agree
13961
to terms that obligate you to collect a royalty for further conveying
13962
from those to whom you convey the Program, the only way you could
13963
satisfy both those terms and this License would be to refrain entirely
13964
from conveying the Program.
13965
13966
<li>Use with the GNU Affero General Public License.
13967
13968
<p>Notwithstanding any other provision of this License, you have
13969
permission to link or combine any covered work with a work licensed
13970
under version 3 of the GNU Affero General Public License into a single
13971
combined work, and to convey the resulting work. The terms of this
13972
License will continue to apply to the part which is the covered work,
13973
but the special requirements of the GNU Affero General Public License,
13974
section 13, concerning interaction through a network will apply to the
13975
combination as such.
13976
13977
<li>Revised Versions of this License.
13978
13979
<p>The Free Software Foundation may publish revised and/or new versions
13980
of the GNU General Public License from time to time. Such new
13981
versions will be similar in spirit to the present version, but may
13982
differ in detail to address new problems or concerns.
16312
13983
16313
13984
<p>Each version is given a distinguishing version number. If the Program
16314
specifies a version number of this License which applies to it and "any
16315
later version", you have the option of following the terms and conditions
16316
either of that version or of any later version published by the Free
16317
Software Foundation. If the Program does not specify a version number of
16318
this License, you may choose any version ever published by the Free Software
16319
Foundation.
16320
16321
</p><li>If you wish to incorporate parts of the Program into other free
16322
programs whose distribution conditions are different, write to the author
16323
to ask for permission. For software which is copyrighted by the Free
16324
Software Foundation, write to the Free Software Foundation; we sometimes
16325
make exceptions for this. Our decision will be guided by the two goals
16326
of preserving the free status of all derivatives of our free software and
16327
of promoting the sharing and reuse of software generally.
16328
16329
<li>BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
16330
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
16331
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
16332
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
16333
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
16334
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
16335
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
16336
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
16337
REPAIR OR CORRECTION.
16338
16339
<li>IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
16340
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
16341
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
16342
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
16343
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
16344
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
16345
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
16346
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
16347
POSSIBILITY OF SUCH DAMAGES.
16348
</ol>
16349
16350
<h3 class="unnumberedsec">How to Apply These Terms to Your New Programs</h3>
16351
16352
<p>If you develop a new program, and you want it to be of the greatest
13985
specifies that a certain numbered version of the GNU General Public
13986
License “or any later version” applies to it, you have the option of
13987
following the terms and conditions either of that numbered version or
13988
of any later version published by the Free Software Foundation. If
13989
the Program does not specify a version number of the GNU General
13990
Public License, you may choose any version ever published by the Free
13991
Software Foundation.
13992
13993
<p>If the Program specifies that a proxy can decide which future versions
13994
of the GNU General Public License can be used, that proxy's public
13995
statement of acceptance of a version permanently authorizes you to
13996
choose that version for the Program.
13997
13998
<p>Later license versions may give you additional or different
13999
permissions. However, no additional obligations are imposed on any
14000
author or copyright holder as a result of your choosing to follow a
14001
later version.
14002
14003
<li>Disclaimer of Warranty.
14004
14005
<p>THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
14006
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
14007
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT
14008
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
14009
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
14010
A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
14011
PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
14012
DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
14013
CORRECTION.
14014
14015
<li>Limitation of Liability.
14016
14017
<p>IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
14018
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR
14019
CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
14020
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES
14021
ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT
14022
NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR
14023
LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM
14024
TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER
14025
PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
14026
14027
<li>Interpretation of Sections 15 and 16.
14028
14029
<p>If the disclaimer of warranty and limitation of liability provided
14030
above cannot be given local legal effect according to their terms,
14031
reviewing courts shall apply local law that most closely approximates
14032
an absolute waiver of all civil liability in connection with the
14033
Program, unless a warranty or assumption of liability accompanies a
14034
copy of the Program in return for a fee.
14035
14036
</ol>
14037
14038
<h3 class="heading">END OF TERMS AND CONDITIONS</h3>
14039
14040
<h3 class="heading">How to Apply These Terms to Your New Programs</h3>
14041
14042
<p>If you develop a new program, and you want it to be of the greatest
16353
14043
possible use to the public, the best way to achieve this is to make it
16354
free software which everyone can redistribute and change under these terms.
14044
free software which everyone can redistribute and change under these
14045
terms.
16355
14046
16356
14047
<p>To do so, attach the following notices to the program. It is safest
16357
14048
to attach them to the start of each source file to most effectively
16358
convey the exclusion of warranty; and each file should have at least
16359
the "copyright" line and a pointer to where the full notice is found.
14049
state the exclusion of warranty; and each file should have at least
14050
the “copyright” line and a pointer to where the full notice is found.
16360
14051
16361
<pre class="smallexample"> <var>one line to give the program's name and an idea of what it does.</var>
16362
Copyright (C) 19<var>yy</var> <var>name of author</var>
16363
16364
This program is free software; you can redistribute it and/or
16365
modify it under the terms of the GNU General Public License
16366
as published by the Free Software Foundation; either version 2
16367
of the License, or (at your option) any later version.
16368
16369
This program is distributed in the hope that it will be useful,
16370
but WITHOUT ANY WARRANTY; without even the implied warranty of
16371
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16372
GNU General Public License for more details.
14052
<pre class="smallexample"> <var>one line to give the program's name and a brief idea of what it does.</var>
14053
Copyright (C) <var>year</var> <var>name of author</var>
14054
14055
This program is free software: you can redistribute it and/or modify
14056
it under the terms of the GNU General Public License as published by
14057
the Free Software Foundation, either version 3 of the License, or (at
14058
your option) any later version.
14059
14060
This program is distributed in the hope that it will be useful, but
14061
WITHOUT ANY WARRANTY; without even the implied warranty of
14062
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14063
General Public License for more details.
16373
14064
16374
14065
You should have received a copy of the GNU General Public License
16375
along with this program; if not, write to the Free Software
16376
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
16377
</pre>
16378
14066
along with this program. If not, see <a href="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</a>.
14067
</pre>
16379
14068
<p>Also add information on how to contact you by electronic and paper mail.
16380
14069
16381
<p>If the program is interactive, make it output a short notice like this
16382
when it starts in an interactive mode:
16383
16384
<pre class="smallexample"> Gnomovision version 69, Copyright (C) 19<var>yy</var> <var>name of author</var>
16385
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
16386
type `show w'. This is free software, and you are welcome
16387
to redistribute it under certain conditions; type `show c'
16388
for details.
16389
</pre>
16390
16391
<p>The hypothetical commands <code>show w</code> and <code>show c</code> should show
16392
the appropriate parts of the General Public License. Of course, the
16393
commands you use may be called something other than <code>show w</code> and
16394
<code>show c</code>; they could even be mouse-clicks or menu items--whatever
16395
suits your program.
16396
16397
<p>You should also get your employer (if you work as a programmer) or your
16398
school, if any, to sign a "copyright disclaimer" for the program, if
16399
necessary. Here is a sample; alter the names:
16400
16401
<pre class="example"> Yoyodyne, Inc., hereby disclaims all copyright
16402
interest in the program `Gnomovision'
16403
(which makes passes at compilers) written
16404
by James Hacker.
16405
16406
<var>signature of Ty Coon</var>, 1 April 1989
16407
Ty Coon, President of Vice
16408
</pre>
16409
16410
<p>This General Public License does not permit incorporating your program into
16411
proprietary programs. If your program is a subroutine library, you may
16412
consider it more useful to permit linking proprietary applications with the
16413
library. If this is what you want to do, use the GNU Library General
16414
Public License instead of this License.
14070
<p>If the program does terminal interaction, make it output a short
14071
notice like this when it starts in an interactive mode:
14072
14073
<pre class="smallexample"> <var>program</var> Copyright (C) <var>year</var> <var>name of author</var>
14074
This program comes with ABSOLUTELY NO WARRANTY; for details type ‘<samp><span class="samp">show w</span></samp>’.
14075
This is free software, and you are welcome to redistribute it
14076
under certain conditions; type ‘<samp><span class="samp">show c</span></samp>’ for details.
14077
</pre>
14078
<p>The hypothetical commands ‘<samp><span class="samp">show w</span></samp>’ and ‘<samp><span class="samp">show c</span></samp>’ should show
14079
the appropriate parts of the General Public License. Of course, your
14080
program's commands might be different; for a GUI interface, you would
14081
use an “about box”.
14082
14083
<p>You should also get your employer (if you work as a programmer) or school,
14084
if any, to sign a “copyright disclaimer” for the program, if necessary.
14085
For more information on this, and how to apply and follow the GNU GPL, see
14086
<a href="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</a>.
14087
14088
<p>The GNU General Public License does not permit incorporating your
14089
program into proprietary programs. If your program is a subroutine
14090
library, you may consider it more useful to permit linking proprietary
14091
applications with the library. If this is what you want to do, use
14092
the GNU Lesser General Public License instead of this License. But
14093
first, please read <a href="http://www.gnu.org/philosophy/why-not-lgpl.html">http://www.gnu.org/philosophy/why-not-lgpl.html</a>.
16415
14094
16416
14095
<div class="node">
16417
14096
<p><hr>
16418
<small class=header>
16419
Node:<a name="Help%20and%20Assistance">Help and Assistance</a>,
16420
Next:<a rel="next" accesskey="n" href="#Documentation%20License">Documentation License</a>,
16421
Previous:<a rel="previous" accesskey="p" href="#License">License</a>,
16422
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
14097
<a name="Help-and-Assistance"></a>
14098
Next: <a rel="next" accesskey="n" href="#Documentation-License">Documentation License</a>,
14099
Previous: <a rel="previous" accesskey="p" href="#License">License</a>,
14100
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
16423
14101
</small>
16424
14102
16425
<br>
14103
16426
14104
</div>
16427
14105
16428
<h2 class="appendix">Help and Assistance</h2>
14106
<h2 class="appendix">Appendix H Help and Assistance</h2>
16429
14107
16430
<p>We have set up a <em>mailing list</em> for general <small>DDD</small>
16431
discussions. If you need help and assistance for solving a <small>DDD</small>
14108
<p><a name="index-Mailing-list-1391"></a><a name="index-Help-1392"></a><a name="index-Assistance-1393"></a>We have set up a <em>mailing list</em> for general <acronym>DDD</acronym>
14109
discussions. If you need help and assistance for solving a <acronym>DDD</acronym>
16432
14110
problem, you find the right people here.
16433
14111
16434
14112
<p>Send message to all receivers of the mailing list to:
16435
14113
16436
14114
<pre class="example"> <a href="mailto:ddd@gnu.org">ddd@gnu.org</a>
16437
</pre>
16438
16439
<p>This mailing list is also the place where new <small>DDD</small> releases are
14115
</pre>
14116
<p>This mailing list is also the place where new <acronym>DDD</acronym> releases are
16440
14117
announced. If you want to subscribe the list, or get more information,
16441
14118
send a mail to
16442
14119
16443
14120
<pre class="example"> <a href="mailto:ddd-request@gnu.org">ddd-request@gnu.org</a>
16444
</pre>
16445
16446
<p>See also <a href="http://www.gnu.org/software/ddd/">the <small>DDD</small> <small>WWW</small> page</a> for recent announcements and other news related to <small>DDD</small>.
14121
</pre>
14122
<p>See also <a href="http://www.gnu.org/software/ddd/">the <acronym>DDD</acronym> <acronym>WWW</acronym> page</a> for recent announcements and other news related to <acronym>DDD</acronym>.
16447
14123
16448
14124
<div class="node">
16449
14125
<p><hr>
16450
<small class=header>
16451
Node:<a name="Documentation%20License">Documentation License</a>,
16452
Next:<a rel="next" accesskey="n" href="#Label%20Index">Label Index</a>,
16453
Previous:<a rel="previous" accesskey="p" href="#Help%20and%20Assistance">Help and Assistance</a>,
16454
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
14126
<a name="Documentation-License"></a>
14127
Next: <a rel="next" accesskey="n" href="#Label-Index">Label Index</a>,
14128
Previous: <a rel="previous" accesskey="p" href="#Help-and-Assistance">Help and Assistance</a>,
14129
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
16455
14130
</small>
16456
14131
16457
<br>
14132
16458
14133
</div>
16459
14134
16460
<h2 class="appendix">GNU Free Documentation License</h2>
16461
14135
<h2 class="appendix">Appendix I GNU Free Documentation License</h2>
14136
14137
<p><a name="index-License_002c-Documentation-1394"></a>
14138
14139
<!-- @appendix GNU Free Documentation License -->
16462
14140
<div align="center">Version 1.1, March 2000</div>
14141
16463
14142
<pre class="display"> Copyright (C) 2000 Free Software Foundation, Inc.
16464
14143
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16465
14144
16466
14145
Everyone is permitted to copy and distribute verbatim copies
16467
14146
of this license document, but changing it is not allowed.
16468
</pre>
14147
</pre>
14148
<pre class="sp">
16469
14149
16470
<br><p>
14150
</pre>
16471
14151
<ol type=1 start=0>
16472
14152
<li>PREAMBLE
16473
14153
16474
14154
<p>The purpose of this License is to make a manual, textbook, or other
16475
written document "free" in the sense of freedom: to assure everyone
14155
written document “free” in the sense of freedom: to assure everyone
16476
14156
the effective freedom to copy and redistribute it, with or without
16477
14157
modifying it, either commercially or noncommercially. Secondarily,
16478
14158
this License preserves for the author and publisher a way to get
16479
14159
credit for their work, while not being considered responsible for
16480
14160
modifications made by others.
16481
14161
16482
<p>This License is a kind of "copyleft", which means that derivative
14162
<p>This License is a kind of “copyleft”, which means that derivative
16483
14163
works of the document must themselves be free in the same sense. It
16484
14164
complements the GNU General Public License, which is a copyleft
16485
14165
license designed for free software.
16492
14172
whether it is published as a printed book. We recommend this License
16493
14173
principally for works whose purpose is instruction or reference.
16494
14174
16495
<br><p>
16496
</p><li>APPLICABILITY AND DEFINITIONS
14175
<pre class="sp">
14176
14177
</pre>
14178
<li>APPLICABILITY AND DEFINITIONS
16497
14179
16498
14180
<p>This License applies to any manual or other work that contains a
16499
14181
notice placed by the copyright holder saying it can be distributed
16500
under the terms of this License. The "Document", below, refers to any
14182
under the terms of this License. The “Document”, below, refers to any
16501
14183
such manual or work. Any member of the public is a licensee, and is
16502
addressed as "you".
14184
addressed as “you”.
16503
14185
16504
<p>A "Modified Version" of the Document means any work containing the
14186
<p>A “Modified Version” of the Document means any work containing the
16505
14187
Document or a portion of it, either copied verbatim, or with
16506
14188
modifications and/or translated into another language.
16507
14189
16508
<p>A "Secondary Section" is a named appendix or a front-matter section of
14190
<p>A “Secondary Section” is a named appendix or a front-matter section of
16509
14191
the Document that deals exclusively with the relationship of the
16510
14192
publishers or authors of the Document to the Document's overall subject
16511
14193
(or to related matters) and contains nothing that could fall directly
16516
14198
commercial, philosophical, ethical or political position regarding
16517
14199
them.
16518
14200
16519
<p>The "Invariant Sections" are certain Secondary Sections whose titles
14201
<p>The “Invariant Sections” are certain Secondary Sections whose titles
16520
14202
are designated, as being those of Invariant Sections, in the notice
16521
14203
that says that the Document is released under this License.
16522
14204
16523
<p>The "Cover Texts" are certain short passages of text that are listed,
14205
<p>The “Cover Texts” are certain short passages of text that are listed,
16524
14206
as Front-Cover Texts or Back-Cover Texts, in the notice that says that
16525
14207
the Document is released under this License.
16526
14208
16527
<p>A "Transparent" copy of the Document means a machine-readable copy,
14209
<p>A “Transparent” copy of the Document means a machine-readable copy,
16528
14210
represented in a format whose specification is available to the
16529
14211
general public, whose contents can be viewed and edited directly and
16530
14212
straightforwardly with generic text editors or (for images composed of
16534
14216
to text formatters. A copy made in an otherwise Transparent file
16535
14217
format whose markup has been designed to thwart or discourage
16536
14218
subsequent modification by readers is not Transparent. A copy that is
16537
not "Transparent" is called "Opaque".
14219
not “Transparent” is called “Opaque”.
16538
14220
16539
14221
<p>Examples of suitable formats for Transparent copies include plain
16540
14222
ASCII without markup, Texinfo input format, LaTeX input format, SGML
16546
14228
machine-generated HTML produced by some word processors for output
16547
14229
purposes only.
16548
14230
16549
<p>The "Title Page" means, for a printed book, the title page itself,
14231
<p>The “Title Page” means, for a printed book, the title page itself,
16550
14232
plus such following pages as are needed to hold, legibly, the material
16551
14233
this License requires to appear in the title page. For works in
16552
formats which do not have any title page as such, "Title Page" means
14234
formats which do not have any title page as such, “Title Page” means
16553
14235
the text near the most prominent appearance of the work's title,
16554
14236
preceding the beginning of the body of the text.
16555
<br><p>
16556
</p><li>VERBATIM COPYING
14237
<pre class="sp">
14238
14239
</pre>
14240
<li>VERBATIM COPYING
16557
14241
16558
14242
<p>You may copy and distribute the Document in any medium, either
16559
14243
commercially or noncommercially, provided that this License, the
16567
14251
16568
14252
<p>You may also lend copies, under the same conditions stated above, and
16569
14253
you may publicly display copies.
16570
<br><p>
16571
</p><li>COPYING IN QUANTITY
14254
<pre class="sp">
14255
14256
</pre>
14257
<li>COPYING IN QUANTITY
16572
14258
16573
14259
<p>If you publish printed copies of the Document numbering more than 100,
16574
14260
and the Document's license notice requires Cover Texts, you must enclose
16604
14290
<p>It is requested, but not required, that you contact the authors of the
16605
14291
Document well before redistributing any large number of copies, to give
16606
14292
them a chance to provide you with an updated version of the Document.
16607
<br><p>
16608
</p><li>MODIFICATIONS
14293
<pre class="sp">
14294
14295
</pre>
14296
<li>MODIFICATIONS
16609
14297
16610
14298
<p>You may copy and distribute a Modified Version of the Document under
16611
14299
the conditions of sections 2 and 3 above, provided that you release
16634
14322
G. Preserve in that license notice the full lists of Invariant Sections
16635
14323
and required Cover Texts given in the Document's license notice.<br>
16636
14324
H. Include an unaltered copy of this License.<br>
16637
I. Preserve the section entitled "History", and its title, and add to
14325
I. Preserve the section entitled “History”, and its title, and add to
16638
14326
it an item stating at least the title, year, new authors, and
16639
14327
publisher of the Modified Version as given on the Title Page. If
16640
there is no section entitled "History" in the Document, create one
14328
there is no section entitled “History” in the Document, create one
16641
14329
stating the title, year, authors, and publisher of the Document as
16642
14330
given on its Title Page, then add an item describing the Modified
16643
14331
Version as stated in the previous sentence.<br>
16644
14332
J. Preserve the network location, if any, given in the Document for
16645
14333
public access to a Transparent copy of the Document, and likewise
16646
14334
the network locations given in the Document for previous versions
16647
it was based on. These may be placed in the "History" section.
14335
it was based on. These may be placed in the “History” section.
16648
14336
You may omit a network location for a work that was published at
16649
14337
least four years before the Document itself, or if the original
16650
14338
publisher of the version it refers to gives permission.<br>
16651
K. In any section entitled "Acknowledgements" or "Dedications",
14339
K. In any section entitled “Acknowledgements” or “Dedications”,
16652
14340
preserve the section's title, and preserve in the section all the
16653
14341
substance and tone of each of the contributor acknowledgements
16654
14342
and/or dedications given therein.<br>
16655
14343
L. Preserve all the Invariant Sections of the Document,
16656
14344
unaltered in their text and in their titles. Section numbers
16657
14345
or the equivalent are not considered part of the section titles.<br>
16658
M. Delete any section entitled "Endorsements". Such a section
14346
M. Delete any section entitled “Endorsements”. Such a section
16659
14347
may not be included in the Modified Version.<br>
16660
N. Do not retitle any existing section as "Endorsements"
14348
N. Do not retitle any existing section as “Endorsements”
16661
14349
or to conflict in title with any Invariant Section.<br>
16662
<br><p>
16663
<p>If the Modified Version includes new front-matter sections or
14350
<pre class="sp">
14351
14352
</pre>
14353
If the Modified Version includes new front-matter sections or
16664
14354
appendices that qualify as Secondary Sections and contain no material
16665
14355
copied from the Document, you may at your option designate some or all
16666
14356
of these sections as invariant. To do this, add their titles to the
16667
14357
list of Invariant Sections in the Modified Version's license notice.
16668
14358
These titles must be distinct from any other section titles.
16669
14359
16670
<p>You may add a section entitled "Endorsements", provided it contains
14360
<p>You may add a section entitled “Endorsements”, provided it contains
16671
14361
nothing but endorsements of your Modified Version by various
16672
parties-for example, statements of peer review or that the text has
14362
parties–for example, statements of peer review or that the text has
16673
14363
been approved by an organization as the authoritative definition of a
16674
14364
standard.
16675
14365
16686
14376
<p>The author(s) and publisher(s) of the Document do not by this License
16687
14377
give permission to use their names for publicity for or to assert or
16688
14378
imply endorsement of any Modified Version.
16689
<br><p>
16690
</p><li>COMBINING DOCUMENTS
14379
<pre class="sp">
14380
14381
</pre>
14382
<li>COMBINING DOCUMENTS
16691
14383
16692
14384
<p>You may combine the Document with other documents released under this
16693
14385
License, under the terms defined in section 4 above for modified
16705
14397
Make the same adjustment to the section titles in the list of
16706
14398
Invariant Sections in the license notice of the combined work.
16707
14399
16708
<p>In the combination, you must combine any sections entitled "History"
14400
<p>In the combination, you must combine any sections entitled “History”
16709
14401
in the various original documents, forming one section entitled
16710
"History"; likewise combine any sections entitled "Acknowledgements",
16711
and any sections entitled "Dedications". You must delete all sections
16712
entitled "Endorsements."
16713
<br><p>
16714
</p><li>COLLECTIONS OF DOCUMENTS
14402
“History”; likewise combine any sections entitled “Acknowledgements”,
14403
and any sections entitled “Dedications”. You must delete all sections
14404
entitled “Endorsements.”
14405
<pre class="sp">
14406
14407
</pre>
14408
<li>COLLECTIONS OF DOCUMENTS
16715
14409
16716
14410
<p>You may make a collection consisting of the Document and other documents
16717
14411
released under this License, and replace the individual copies of this
16723
14417
it individually under this License, provided you insert a copy of this
16724
14418
License into the extracted document, and follow this License in all
16725
14419
other respects regarding verbatim copying of that document.
16726
<br><p>
16727
</p><li>AGGREGATION WITH INDEPENDENT WORKS
14420
<pre class="sp">
14421
14422
</pre>
14423
<li>AGGREGATION WITH INDEPENDENT WORKS
16728
14424
16729
14425
<p>A compilation of the Document or its derivatives with other separate
16730
14426
and independent documents or works, in or on a volume of a storage or
16731
14427
distribution medium, does not as a whole count as a Modified Version
16732
14428
of the Document, provided no compilation copyright is claimed for the
16733
compilation. Such a compilation is called an "aggregate", and this
14429
compilation. Such a compilation is called an “aggregate”, and this
16734
14430
License does not apply to the other self-contained works thus compiled
16735
14431
with the Document, on account of their being thus compiled, if they
16736
14432
are not themselves derivative works of the Document.
16740
14436
of the entire aggregate, the Document's Cover Texts may be placed on
16741
14437
covers that surround only the Document within the aggregate.
16742
14438
Otherwise they must appear on covers around the whole aggregate.
16743
<br><p>
16744
</p><li>TRANSLATION
14439
<pre class="sp">
14440
14441
</pre>
14442
<li>TRANSLATION
16745
14443
16746
14444
<p>Translation is considered a kind of modification, so you may
16747
14445
distribute translations of the Document under the terms of section 4.
16753
14451
original English version of this License. In case of a disagreement
16754
14452
between the translation and the original English version of this
16755
14453
License, the original English version will prevail.
16756
<br><p>
16757
</p><li>TERMINATION
14454
<pre class="sp">
14455
14456
</pre>
14457
<li>TERMINATION
16758
14458
16759
14459
<p>You may not copy, modify, sublicense, or distribute the Document except
16760
14460
as expressly provided for under this License. Any other attempt to
16763
14463
parties who have received copies, or rights, from you under this
16764
14464
License will not have their licenses terminated so long as such
16765
14465
parties remain in full compliance.
16766
<br><p>
16767
</p><li>FUTURE REVISIONS OF THIS LICENSE
14466
<pre class="sp">
14467
14468
</pre>
14469
<li>FUTURE REVISIONS OF THIS LICENSE
16768
14470
16769
14471
<p>The Free Software Foundation may publish new, revised versions
16770
14472
of the GNU Free Documentation License from time to time. Such new
16774
14476
16775
14477
<p>Each version of the License is given a distinguishing version number.
16776
14478
If the Document specifies that a particular numbered version of this
16777
License "or any later version" applies to it, you have the option of
14479
License “or any later version” applies to it, you have the option of
16778
14480
following the terms and conditions either of that specified version or
16779
14481
of any later version that has been published (not as a draft) by the
16780
14482
Free Software Foundation. If the Document does not specify a version
16785
14487
16786
14488
<h3 class="unnumberedsec">ADDENDUM: How to use this License for your documents</h3>
16787
14489
16788
<p>To use this License in a document you have written, include a copy of
14490
<p>To use this License in a document you have written, include a copy of
16789
14491
the License in the document and put the following copyright and
16790
14492
license notices just after the title page:
16791
14493
16798
14500
Front-Cover Texts being <var>list</var>, and with the Back-Cover Texts being <var>list</var>.
16799
14501
A copy of the license is included in the section entitled ``GNU
16800
14502
Free Documentation License''.
16801
</pre>
16802
If you have no Invariant Sections, write "with no Invariant Sections"
14503
</pre>
14504
<p>If you have no Invariant Sections, write “with no Invariant Sections”
16803
14505
instead of saying which ones are invariant. If you have no
16804
Front-Cover Texts, write "no Front-Cover Texts" instead of
16805
"Front-Cover Texts being <var>list</var>"; likewise for Back-Cover Texts.
14506
Front-Cover Texts, write “no Front-Cover Texts” instead of
14507
“Front-Cover Texts being <var>list</var>”; likewise for Back-Cover Texts.
16806
14508
16807
14509
<p>If your document contains nontrivial examples of program code, we
16808
14510
recommend releasing these examples in parallel under your choice of
16811
14513
16812
14514
<div class="node">
16813
14515
<p><hr>
16814
<small class=header>
16815
Node:<a name="Label%20Index">Label Index</a>,
16816
Next:<a rel="next" accesskey="n" href="#Key%20Index">Key Index</a>,
16817
Previous:<a rel="previous" accesskey="p" href="#Documentation%20License">Documentation License</a>,
16818
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
14516
<a name="Label-Index"></a>
14517
Next: <a rel="next" accesskey="n" href="#Key-Index">Key Index</a>,
14518
Previous: <a rel="previous" accesskey="p" href="#Documentation-License">Documentation License</a>,
14519
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
16819
14520
</small>
16820
14521
16821
<br>
14522
16822
14523
</div>
16823
14524
16824
14525
<h2 class="unnumbered">Label Index</h2>
16825
14526
16826
14527
<ul class="index-lb" compact>
16827
<li><code>()</code>: <a href="#GDB%20Argument%20Commands">GDB Argument Commands</a>
16828
<li><code>3-D Lines</code>: <a href="#Plot%20Appearance">Plot Appearance</a>
16829
<li><code>Abort</code>: <a href="#Program%20Menu">Program Menu</a>, <a href="#Quitting">Quitting</a>
16830
<li><code>About </code><small>DDD</small><code></code>: <a href="#Help%20Menu">Help Menu</a>
16831
<li><code>Align on Grid</code>: <a href="#Data%20Menu">Data Menu</a>
16832
<li><code>All Signals</code>: <a href="#Signals">Signals</a>
16833
<li><code>Apply</code>: <a href="#Commands%20Menu">Commands Menu</a>
16834
<li><code>Attach</code>: <a href="#Attaching%20to%20a%20Process">Attaching to a Process</a>
16835
<li><code>Attach to Process</code>: <a href="#Attaching%20to%20a%20Process">Attaching to a Process</a>, <a href="#File%20Menu">File Menu</a>
16836
<li><code>Auto-align Displays on Nearest Grid Point</code>: <a href="#Aligning%20Displays">Aligning Displays</a>
16837
<li><code>Automatic Display of Button Hints</code>: <a href="#Button%20tips">Button tips</a>
16838
<li><code>Automatic Display of Variable Values</code>: <a href="#Value%20Tips">Value Tips</a>
16839
<li><code>Backtrace</code>: <a href="#Status%20Menu">Status Menu</a>
16840
<li><code>Bash Console</code>: <a href="#View%20Menu">View Menu</a>
16841
<li><code>Bash Reference</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>
16842
<li><code>Break</code>: <a href="#Setting%20Breakpoints">Setting Breakpoints</a>, <a href="#Tool%20Bar">Tool Bar</a>
16843
<li><code>Breakpoints</code>: <a href="#Source%20Menu">Source Menu</a>
16844
<li><code>Button</code>: <a href="#GDB%20Simple%20Commands">GDB Simple Commands</a>
16845
<li><code>Cache Machine Code</code>: <a href="#Customizing%20Machine%20Code">Customizing Machine Code</a>
16846
<li><code>Cache source files</code>: <a href="#Customizing%20Source%20Lookup">Customizing Source Lookup</a>
16847
<li><code>Change Directory</code>: <a href="#Working%20Directory">Working Directory</a>, <a href="#File%20Menu">File Menu</a>
16848
<li><code>Clear</code>: <a href="#Disabling%20Breakpoints">Disabling Breakpoints</a>, <a href="#Deleting%20Breakpoints">Deleting Breakpoints</a>, <a href="#Tool%20Bar">Tool Bar</a>, <a href="#Edit%20Menu">Edit Menu</a>
16849
<li><code>Clear Line</code>: <a href="#Commands%20Menu">Commands Menu</a>
16850
<li><code>Clear Undo Buffer</code>: <a href="#Customizing%20Undo">Customizing Undo</a>
16851
<li><code>Clear Window</code>: <a href="#Commands%20Menu">Commands Menu</a>
16852
<li><code>Close</code>: <a href="#File%20Menu">File Menu</a>
16853
<li><code>Close data window when deleting last display</code>: <a href="#Deleting%20Displays">Deleting Displays</a>
16854
<li><code>Cluster</code>: <a href="#Clustering">Clustering</a>
16855
<li><code>Cluster Data Displays</code>: <a href="#Clustering">Clustering</a>
16856
<li><code>clustered</code>: <a href="#Clustering">Clustering</a>
16857
<li><code>Color</code>: <a href="#Printing%20the%20Graph">Printing the Graph</a>
16858
<li><code>Command</code>: <a href="#GDB%20Simple%20Commands">GDB Simple Commands</a>, <a href="#Entering%20Plotting%20Commands">Entering Plotting Commands</a>
16859
<li><code>Command History</code>: <a href="#Commands%20Menu">Commands Menu</a>
16860
<li><code>Command Tool</code>: <a href="#View%20Menu">View Menu</a>
16861
<li><code>Commands</code>: <a href="#Commands%20Menu">Commands Menu</a>, <a href="#Menu%20Bar">Menu Bar</a>
16862
<li><code>Complete</code>: <a href="#Commands%20Menu">Commands Menu</a>
16863
<li><code>Cont</code>: <a href="#Command%20Tool">Command Tool</a>
16864
<li><code>Continue</code>: <a href="#Continuing%20Somewhere%20Else">Continuing Somewhere Else</a>, <a href="#Resuming%20Execution">Resuming Execution</a>, <a href="#Program%20Menu">Program Menu</a>
16865
<li><code>Continue Automatically when Mouse Pointer is Frozen</code>: <a href="#Stopping%20X%20Programs">Stopping X Programs</a>
16866
<li><code>Continue Until Here</code>: <a href="#Temporary%20Breakpoints">Temporary Breakpoints</a>
16867
<li><code>Continue Without Signal</code>: <a href="#Signals">Signals</a>, <a href="#Program%20Menu">Program Menu</a>
16868
<li><code>Contour</code>: <a href="#Plot%20Appearance">Plot Appearance</a>
16869
<li><code>Copy</code>: <a href="#Deleting%20Displays">Deleting Displays</a>, <a href="#Edit%20Menu">Edit Menu</a>
16870
<li><code>Ctrl+A is</code>: <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>
16871
<li><code>Ctrl+C is</code>: <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>
16872
<li><code>Cut</code>: <a href="#Deleting%20Displays">Deleting Displays</a>, <a href="#Edit%20Menu">Edit Menu</a>
16873
<li><code>Data</code>: <a href="#Data%20Menu">Data Menu</a>, <a href="#Menu%20Bar">Menu Bar</a>
16874
<li><code>Data Scrolling</code>: <a href="#Scrolling%20Data">Scrolling Data</a>
16875
<li><code>Data Window</code>: <a href="#View%20Menu">View Menu</a>
16876
<li><code>DBX Console</code>: <a href="#View%20Menu">View Menu</a>
16877
<li><code>DBX Reference</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>
16878
<li><code>DBX Settings</code>: <a href="#Edit%20Menu">Edit Menu</a>
16879
<li><code>DDD License</code>: <a href="#Help%20Menu">Help Menu</a>
16880
<li><code>DDD News</code>: <a href="#Help%20Menu">Help Menu</a>
16881
<li><code>DDD Reference</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>
16882
<li><code>DDD Splash Screen</code>: <a href="#Splash%20Screen">Splash Screen</a>
16883
<li><code>DDD </code><small>WWW</small><code> Page</code>: <a href="#Getting%20Help">Getting Help</a>
16884
<li><code>DDD WWW Page</code>: <a href="#Help%20Menu">Help Menu</a>
16885
<li><code>Debug DDD</code>: <a href="#Maintenance%20Menu">Maintenance Menu</a>
16886
<li><code>Debugger Reference</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>
16887
<li><code>Debugger Settings</code>: <a href="#Edit%20Menu">Edit Menu</a>
16888
<li><code>Debugger Type</code>: <a href="#Debugger%20Invocation">Debugger Invocation</a>
16889
<li><code>Define Command</code>: <a href="#Commands%20Menu">Commands Menu</a>
16890
<li><code>Delete</code>: <a href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>, <a href="#Deleting%20Breakpoints">Deleting Breakpoints</a>, <a href="#Edit%20Menu">Edit Menu</a>, <a href="#Deleting%20Sessions">Deleting Sessions</a>
16891
<li><code>Delete Breakpoint</code>: <a href="#Deleting%20Breakpoints">Deleting Breakpoints</a>
16892
<li><code>Detach Process</code>: <a href="#Attaching%20to%20a%20Process">Attaching to a Process</a>, <a href="#File%20Menu">File Menu</a>
16893
<li><code>Detect Aliases</code>: <a href="#Shared%20Structures">Shared Structures</a>, <a href="#Data%20Menu">Data Menu</a>
16894
<li><code>Determine Automatically from Arguments</code>: <a href="#Debugger%20Invocation">Debugger Invocation</a>
16895
<li><code>Disable</code>: <a href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>, <a href="#Disabling%20Breakpoints">Disabling Breakpoints</a>
16896
<li><code>Disable Breakpoint</code>: <a href="#Disabling%20Breakpoints">Disabling Breakpoints</a>
16897
<li><code>Disp *</code>: <a href="#Dereferencing%20Pointers">Dereferencing Pointers</a>
16898
<li><code>Display</code>: <a href="#Creating%20Single%20Displays">Creating Single Displays</a>, <a href="#Display%20Basics">Display Basics</a>, <a href="#Tool%20Bar">Tool Bar</a>
16899
<li><code>Display ()</code>: <a href="#Data%20Menu">Data Menu</a>
16900
<li><code>Display *</code>: <a href="#Dereferencing%20Pointers">Dereferencing Pointers</a>
16901
<li><code>Display *()</code>: <a href="#Dereferencing%20Pointers">Dereferencing Pointers</a>
16902
<li><code>Display Arguments</code>: <a href="#Displaying%20Local%20Variables">Displaying Local Variables</a>, <a href="#Data%20Menu">Data Menu</a>
16903
<li><code>Display Line Numbers</code>: <a href="#Source%20Menu">Source Menu</a>
16904
<li><code>Display Local Variables</code>: <a href="#Displaying%20Local%20Variables">Displaying Local Variables</a>, <a href="#Data%20Menu">Data Menu</a>
16905
<li><code>Display Machine Code</code>: <a href="#Source%20Menu">Source Menu</a>
16906
<li><code>Display Source Line Numbers</code>: <a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
16907
<li><code>Display Two-Dimensional Arrays as Tables</code>: <a href="#Arrays%20as%20Tables">Arrays as Tables</a>
16908
<li><code>Displays</code>: <a href="#Data%20Menu">Data Menu</a>
16909
<li><code>Do Nothing</code>: <a href="#Maintenance%20Menu">Maintenance Menu</a>
16910
<li><code>Down</code>: <a href="#Selecting%20a%20frame">Selecting a frame</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Status%20Menu">Status Menu</a>
16911
<li><code>Dump Core</code>: <a href="#Maintenance%20Menu">Maintenance Menu</a>
16912
<li><code>Dump Core Now</code>: <a href="#Maintenance%20Menu">Maintenance Menu</a>
16913
<li><code>Edit</code>: <a href="#Editing%20Source%20Code">Editing Source Code</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Edit%20Menu">Edit Menu</a>, <a href="#Menu%20Bar">Menu Bar</a>
16914
<li><code>Edit <<</code>: <a href="#GDB%20Simple%20Commands">GDB Simple Commands</a>
16915
<li><code>Edit >></code>: <a href="#GDB%20Simple%20Commands">GDB Simple Commands</a>, <a href="#Breakpoint%20Commands">Breakpoint Commands</a>
16916
<li><code>Edit Buttons</code>: <a href="#Defining%20Buttons">Defining Buttons</a>, <a href="#Commands%20Menu">Commands Menu</a>
16917
<li><code>Edit Menu</code>: <a href="#Display%20Shortcuts">Display Shortcuts</a>
16918
<li><code>Edit Source</code>: <a href="#Editing%20Source%20Code">Editing Source Code</a>, <a href="#Source%20Menu">Source Menu</a>
16919
<li><code>Edit Sources</code>: <a href="#Editing%20Source%20Code">Editing Source Code</a>
16920
<li><code>Edit Themes</code>: <a href="#Editing%20Themes">Editing Themes</a>
16921
<li><code>Enable</code>: <a href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>, <a href="#Disabling%20Breakpoints">Disabling Breakpoints</a>
16922
<li><code>Enable Breakpoint</code>: <a href="#Disabling%20Breakpoints">Disabling Breakpoints</a>
16923
<li><code>Enable supported buttons only</code>: <a href="#Defining%20Buttons">Defining Buttons</a>
16924
<li><code>End</code>: <a href="#GDB%20Simple%20Commands">GDB Simple Commands</a>, <a href="#Breakpoint%20Commands">Breakpoint Commands</a>
16925
<li><code>Execute</code>: <a href="#GDB%20Simple%20Commands">GDB Simple Commands</a>
16926
<li><code>Execution Window</code>: <a href="#Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>, <a href="#View%20Menu">View Menu</a>
16927
<li><code>Exit</code>: <a href="#File%20Menu">File Menu</a>, <a href="#Quitting">Quitting</a>
16928
<li><code>File</code>: <a href="#File%20Menu">File Menu</a>, <a href="#Menu%20Bar">Menu Bar</a>
16929
<li><code>File Name</code>: <a href="#Printing%20the%20Graph">Printing the Graph</a>
16930
<li><code>Find <<</code>: <a href="#Textual%20Search">Textual Search</a>
16931
<li><code>Find << ()</code>: <a href="#Source%20Menu">Source Menu</a>
16932
<li><code>Find >></code>: <a href="#Textual%20Search">Textual Search</a>, <a href="#Tool%20Bar">Tool Bar</a>
16933
<li><code>Find >> ()</code>: <a href="#Source%20Menu">Source Menu</a>
16934
<li><code>Find Backward</code>: <a href="#Commands%20Menu">Commands Menu</a>
16935
<li><code>Find Case Sensitive</code>: <a href="#Source%20Menu">Source Menu</a>
16936
<li><code>Find Forward</code>: <a href="#Commands%20Menu">Commands Menu</a>
16937
<li><code>Find Words Only</code>: <a href="#Textual%20Search">Textual Search</a>, <a href="#Source%20Menu">Source Menu</a>
16938
<li><code>Finish</code>: <a href="#Resuming%20Execution">Resuming Execution</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Program%20Menu">Program Menu</a>
16939
<li><code>GDB Console</code>: <a href="#View%20Menu">View Menu</a>
16940
<li><code>GDB Reference</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>
16941
<li><code>GDB Settings</code>: <a href="#Edit%20Menu">Edit Menu</a>
16942
<li><code>Get Core File</code>: <a href="#Customizing%20Sessions">Customizing Sessions</a>
16943
<li><code>Help</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>, <a href="#Menu%20Bar">Menu Bar</a>
16944
<li><code>Hide</code>: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>, <a href="#Tool%20Bar">Tool Bar</a>
16945
<li><code>Iconify all windows at once</code>: <a href="#Icons">Icons</a>
16946
<li><code>Ignore Count</code>: <a href="#Breakpoint%20Ignore%20Counts">Breakpoint Ignore Counts</a>
16947
<li><code>Include Core Dump</code>: <a href="#Saving%20Sessions">Saving Sessions</a>
16948
<li><code>Interrupt</code>: <a href="#Interrupting">Interrupting</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Program%20Menu">Program Menu</a>
16949
<li><code>JDB Console</code>: <a href="#View%20Menu">View Menu</a>
16950
<li><code>JDB Reference</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>
16951
<li><code>JDB Settings</code>: <a href="#Edit%20Menu">Edit Menu</a>
16952
<li><code>Kill</code>: <a href="#Killing%20the%20Program">Killing the Program</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Program%20Menu">Program Menu</a>
16953
<li><code>Ladebug Console</code>: <a href="#View%20Menu">View Menu</a>
16954
<li><code>Ladebug Reference</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>
16955
<li><code>Ladebug Settings</code>: <a href="#Edit%20Menu">Edit Menu</a>
16956
<li><code>Landscape</code>: <a href="#Printing%20Plots">Printing Plots</a>
16957
<li><code>Layout Graph</code>: <a href="#Automatic%20Layout">Automatic Layout</a>, <a href="#Data%20Menu">Data Menu</a>
16958
<li><code>Left to right</code>: <a href="#Placement">Placement</a>
16959
<li><code>List Processes</code>: <a href="#Attaching%20to%20a%20Process">Attaching to a Process</a>
16960
<li><code>Lookup</code>: <a href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>, <a href="#Looking%20up%20Definitions">Looking up Definitions</a>, <a href="#Tool%20Bar">Tool Bar</a>
16961
<li><code>Lookup ()</code>: <a href="#Source%20Menu">Source Menu</a>
16962
<li><code>Machine Code Indentation</code>: <a href="#Customizing%20Machine%20Code">Customizing Machine Code</a>
16963
<li><code>Machine Code Window</code>: <a href="#View%20Menu">View Menu</a>
16964
<li><code>Maintenance</code>: <a href="#Maintenance%20Menu">Maintenance Menu</a>, <a href="#Menu%20Bar">Menu Bar</a>
16965
<li><code>Make</code>: <a href="#Recompiling">Recompiling</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#File%20Menu">File Menu</a>
16966
<li><code>Memory</code>: <a href="#Examining%20Memory">Examining Memory</a>, <a href="#Data%20Menu">Data Menu</a>
16967
<li><code>New Display</code>: <a href="#Display%20Shortcuts">Display Shortcuts</a>
16968
<li><code>New Game</code>: <a href="#Maintenance%20Menu">Maintenance Menu</a>
16969
<li><code>Next</code>: <a href="#Resuming%20Execution">Resuming Execution</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Commands%20Menu">Commands Menu</a>, <a href="#Program%20Menu">Program Menu</a>
16970
<li><code>Next Instruction</code>: <a href="#Machine%20Code%20Execution">Machine Code Execution</a>, <a href="#Program%20Menu">Program Menu</a>
16971
<li><code>Nexti</code>: <a href="#Machine%20Code%20Execution">Machine Code Execution</a>, <a href="#Command%20Tool">Command Tool</a>
16972
<li><code>On item</code>: <a href="#Help%20Menu">Help Menu</a>
16973
<li><code>Open</code>: <a href="#Opening%20Source%20Files">Opening Source Files</a>, <a href="#Opening%20Core%20Dumps">Opening Core Dumps</a>, <a href="#Opening%20Programs">Opening Programs</a>
16974
<li><code>Open Class</code>: <a href="#Opening%20Programs">Opening Programs</a>, <a href="#File%20Menu">File Menu</a>
16975
<li><code>Open Core Dump</code>: <a href="#File%20Menu">File Menu</a>
16976
<li><code>Open Program</code>: <a href="#Attaching%20to%20a%20Process">Attaching to a Process</a>, <a href="#Opening%20Programs">Opening Programs</a>, <a href="#File%20Menu">File Menu</a>
16977
<li><code>Open Recent</code>: <a href="#Opening%20Programs">Opening Programs</a>, <a href="#File%20Menu">File Menu</a>
16978
<li><code>Open Session</code>: <a href="#File%20Menu">File Menu</a>, <a href="#Resuming%20Sessions">Resuming Sessions</a>
16979
<li><code>Open Source</code>: <a href="#Opening%20Source%20Files">Opening Source Files</a>, <a href="#File%20Menu">File Menu</a>
16980
<li><code>Orientation</code>: <a href="#Printing%20the%20Graph">Printing the Graph</a>
16981
<li><code>Other</code>: <a href="#Display%20Shortcuts">Display Shortcuts</a>
16982
<li><code>Overview</code>: <a href="#Help%20Menu">Help Menu</a>
16983
<li><code>Paper Size</code>: <a href="#Printing%20Plots">Printing Plots</a>, <a href="#Printing%20the%20Graph">Printing the Graph</a>
16984
<li><code>Pass</code>: <a href="#Signals">Signals</a>
16985
<li><code>Paste</code>: <a href="#Deleting%20Displays">Deleting Displays</a>, <a href="#Edit%20Menu">Edit Menu</a>
16986
<li><code>Perl Console</code>: <a href="#View%20Menu">View Menu</a>
16987
<li><code>Perl Reference</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>
16988
<li><code>Perl Settings</code>: <a href="#Edit%20Menu">Edit Menu</a>
16989
<li><code>Placement</code>: <a href="#Clustering">Clustering</a>, <a href="#Placement">Placement</a>
16990
<li><code>Plot</code>: <a href="#Gnuplot%20Invocation">Gnuplot Invocation</a>, <a href="#Plot%20Appearance">Plot Appearance</a>, <a href="#Tool%20Bar">Tool Bar</a>
16991
<li><code>Plot Window</code>: <a href="#Gnuplot%20Invocation">Gnuplot Invocation</a>
16992
<li><code>Portrait</code>: <a href="#Printing%20Plots">Printing Plots</a>
16993
<li><code>Preferences</code>: <a href="#Edit%20Menu">Edit Menu</a>
16994
<li><code>Previous</code>: <a href="#Commands%20Menu">Commands Menu</a>
16995
<li><code>Print</code>: <a href="#Printing%20Values">Printing Values</a>, <a href="#Signals">Signals</a>, <a href="#Editing%20all%20Watchpoints">Editing all Watchpoints</a>, <a href="#Editing%20Watchpoint%20Properties">Editing Watchpoint Properties</a>, <a href="#Tool%20Bar">Tool Bar</a>
16996
<li><code>Print ()</code>: <a href="#Data%20Menu">Data Menu</a>
16997
<li><code>Print Command</code>: <a href="#Printing%20the%20Graph">Printing the Graph</a>
16998
<li><code>Print Graph</code>: <a href="#Printing%20the%20Graph">Printing the Graph</a>, <a href="#File%20Menu">File Menu</a>
16999
<li><code>Print Plot</code>: <a href="#Printing%20Plots">Printing Plots</a>
17000
<li><code>Program</code>: <a href="#Program%20Menu">Program Menu</a>, <a href="#Menu%20Bar">Menu Bar</a>
17001
<li><code>PYDB Console</code>: <a href="#View%20Menu">View Menu</a>
17002
<li><code>PYDB Reference</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>
17003
<li><code>PYDB Settings</code>: <a href="#Edit%20Menu">Edit Menu</a>
17004
<li><code>Quit Search</code>: <a href="#Commands%20Menu">Commands Menu</a>
17005
<li><code>Record</code>: <a href="#GDB%20Simple%20Commands">GDB Simple Commands</a>, <a href="#Breakpoint%20Commands">Breakpoint Commands</a>
17006
<li><code>Red Background</code>: <a href="#Applying%20Data%20Themes%20to%20Several%20Values">Applying Data Themes to Several Values</a>
17007
<li><code>Redo</code>: <a href="#Undoing%20Program%20Execution">Undoing Program Execution</a>, <a href="#Looking%20up%20Previous%20Locations">Looking up Previous Locations</a>, <a href="#Undo%20and%20Redo">Undo and Redo</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Edit%20Menu">Edit Menu</a>
17008
<li><code>Refer to Program Sources</code>: <a href="#Customizing%20Source%20Lookup">Customizing Source Lookup</a>
17009
<li><code>Refresh</code>: <a href="#Data%20Menu">Data Menu</a>
17010
<li><code>Refresh Displays</code>: <a href="#Repeated%20Values">Repeated Values</a>, <a href="#Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>
17011
<li><code>Registers</code>: <a href="#Registers">Registers</a>, <a href="#Status%20Menu">Status Menu</a>
17012
<li><code>Reload Source</code>: <a href="#Editing%20Source%20Code">Editing Source Code</a>, <a href="#Source%20Menu">Source Menu</a>
17013
<li><code>Remove Menu</code>: <a href="#Maintenance%20Menu">Maintenance Menu</a>
17014
<li><code>Reset</code>: <a href="#Signals">Signals</a>
17015
<li><code>Restart</code>: <a href="#File%20Menu">File Menu</a>
17016
<li><code>Rotate</code>: <a href="#Tool%20Bar">Tool Bar</a>
17017
<li><code>Rotate Graph</code>: <a href="#Rotating%20the%20Graph">Rotating the Graph</a>, <a href="#Data%20Menu">Data Menu</a>
17018
<li><code>Run</code>: <a href="#Starting%20Program%20Execution">Starting Program Execution</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Program%20Menu">Program Menu</a>
17019
<li><code>Run Again</code>: <a href="#Starting%20Program%20Execution">Starting Program Execution</a>, <a href="#Program%20Menu">Program Menu</a>
17020
<li><code>Run in Execution Window</code>: <a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>, <a href="#Program%20Menu">Program Menu</a>
17021
<li><code>Save Data As</code>: <a href="#Exporting%20Plot%20Data">Exporting Plot Data</a>
17022
<li><code>Save Options</code>: <a href="#Signals">Signals</a>, <a href="#Edit%20Menu">Edit Menu</a>
17023
<li><code>Save Session As</code>: <a href="#Signals">Signals</a>, <a href="#File%20Menu">File Menu</a>, <a href="#Saving%20Sessions">Saving Sessions</a>
17024
<li><code>Scale</code>: <a href="#Plot%20Appearance">Plot Appearance</a>
17025
<li><code>Search path for source files</code>: <a href="#Source%20Path">Source Path</a>
17026
<li><code>Select All</code>: <a href="#Edit%20Menu">Edit Menu</a>
17027
<li><code>Selected Only</code>: <a href="#Printing%20Plots">Printing Plots</a>, <a href="#Printing%20the%20Graph">Printing the Graph</a>
17028
<li><code>Send</code>: <a href="#Signals">Signals</a>
17029
<li><code>Set</code>: <a href="#Assignment">Assignment</a>, <a href="#Tool%20Bar">Tool Bar</a>
17030
<li><code>Set Execution Position</code>: <a href="#Continuing%20Somewhere%20Else">Continuing Somewhere Else</a>
17031
<li><code>Set Temporary Breakpoint</code>: <a href="#Temporary%20Breakpoints">Temporary Breakpoints</a>
17032
<li><code>Set Value</code>: <a href="#Assignment">Assignment</a>
17033
<li><code>Show</code>: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>, <a href="#Tool%20Bar">Tool Bar</a>
17034
<li><code>Show All</code>: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17035
<li><code>Show Just</code>: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17036
<li><code>Show More</code>: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17037
<li><code>Show Position and Breakpoints</code>: <a href="#Customizing%20Glyphs">Customizing Glyphs</a>
17038
<li><code>Signals</code>: <a href="#Signals">Signals</a>, <a href="#Status%20Menu">Status Menu</a>
17039
<li><code>Small Titles</code>: <a href="#Using%20Data%20Themes">Using Data Themes</a>
17040
<li><code>Small Values</code>: <a href="#Using%20Data%20Themes">Using Data Themes</a>
17041
<li><code>Source</code>: <a href="#Source%20Menu">Source Menu</a>, <a href="#Menu%20Bar">Menu Bar</a>
17042
<li><code>Source indentation</code>: <a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
17043
<li><code>Source Window</code>: <a href="#View%20Menu">View Menu</a>
17044
<li><code>Status</code>: <a href="#Status%20Menu">Status Menu</a>, <a href="#Menu%20Bar">Menu Bar</a>
17045
<li><code>Status Displays</code>: <a href="#Displaying%20Program%20Status">Displaying Program Status</a>, <a href="#Data%20Menu">Data Menu</a>
17046
<li><code>Step</code>: <a href="#Resuming%20Execution">Resuming Execution</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Program%20Menu">Program Menu</a>
17047
<li><code>Step Instruction</code>: <a href="#Machine%20Code%20Execution">Machine Code Execution</a>, <a href="#Program%20Menu">Program Menu</a>
17048
<li><code>Stepi</code>: <a href="#Machine%20Code%20Execution">Machine Code Execution</a>, <a href="#Command%20Tool">Command Tool</a>
17049
<li><code>Stop</code>: <a href="#Signals">Signals</a>
17050
<li><code>Suppress Values</code>: <a href="#Using%20Data%20Themes">Using Data Themes</a>, <a href="#Deleting%20Displays">Deleting Displays</a>
17051
<li><code>Suppress X warnings</code>: <a href="#X%20Warnings">X Warnings</a>
17052
<li><code>Tab Width</code>: <a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
17053
<li><code>Temp</code>: <a href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>
17054
<li><code>Theme</code>: <a href="#Using%20Data%20Themes">Using Data Themes</a>
17055
<li><code>Themes</code>: <a href="#Editing%20Themes">Editing Themes</a>
17056
<li><code>Threads</code>: <a href="#Threads">Threads</a>, <a href="#Status%20Menu">Status Menu</a>
17057
<li><code>Threshold for repeated print elements</code>: <a href="#Repeated%20Values">Repeated Values</a>
17058
<li><code>Tic Tac Toe</code>: <a href="#Maintenance%20Menu">Maintenance Menu</a>
17059
<li><code>Tiny Values</code>: <a href="#Using%20Data%20Themes">Using Data Themes</a>
17060
<li><code>Tip of the Day</code>: <a href="#Help%20Menu">Help Menu</a>
17061
<li><code>Tool Bar Appearance</code>: <a href="#Window%20Layout">Window Layout</a>
17062
<li><code>Tool Buttons Location</code>: <a href="#Disabling%20the%20Command%20Tool">Disabling the Command Tool</a>
17063
<li><code>Top to bottom</code>: <a href="#Placement">Placement</a>
17064
<li><code>Uncluster</code>: <a href="#Clustering">Clustering</a>
17065
<li><code>Uncompress</code>: <a href="#Help%20Helpers">Help Helpers</a>
17066
<li><code>Undisp</code>: <a href="#Deleting%20Displays">Deleting Displays</a>, <a href="#Tool%20Bar">Tool Bar</a>
17067
<li><code>Undisplay</code>: <a href="#Display%20Basics">Display Basics</a>
17068
<li><code>Undo</code>: <a href="#Deleting%20Displays">Deleting Displays</a>, <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>, <a href="#Undoing%20Program%20Execution">Undoing Program Execution</a>, <a href="#Selecting%20a%20frame">Selecting a frame</a>, <a href="#Looking%20up%20Previous%20Locations">Looking up Previous Locations</a>, <a href="#Undo%20and%20Redo">Undo and Redo</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Edit%20Menu">Edit Menu</a>
17069
<li><code>Undo Buffer Size</code>: <a href="#Customizing%20Undo">Customizing Undo</a>
17070
<li><code>Uniconify When Ready</code>: <a href="#Program%20Stop">Program Stop</a>
17071
<li><code>Until</code>: <a href="#Resuming%20Execution">Resuming Execution</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Program%20Menu">Program Menu</a>
17072
<li><code>Unwatch</code>: <a href="#Tool%20Bar">Tool Bar</a>
17073
<li><code>Up</code>: <a href="#Selecting%20a%20frame">Selecting a frame</a>, <a href="#Command%20Tool">Command Tool</a>, <a href="#Status%20Menu">Status Menu</a>
17074
<li><code>View</code>: <a href="#Plot%20Appearance">Plot Appearance</a>, <a href="#View%20Menu">View Menu</a>, <a href="#Menu%20Bar">Menu Bar</a>
17075
<li><code>Warn if Multiple DDD Instances are Running</code>: <a href="#Multiple%20Instances">Multiple Instances</a>
17076
<li><code>Watch</code>: <a href="#Editing%20Watchpoint%20Properties">Editing Watchpoint Properties</a>, <a href="#Setting%20Watchpoints">Setting Watchpoints</a>, <a href="#Tool%20Bar">Tool Bar</a>
17077
<li><code>Watchpoints</code>: <a href="#Data%20Menu">Data Menu</a>
17078
<li><code>Web Browser</code>: <a href="#Help%20Helpers">Help Helpers</a>
17079
<li><code>What Now?</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>
17080
<li><code>When DDD Crashes</code>: <a href="#Maintenance%20Menu">Maintenance Menu</a>
17081
<li><code>Window Layout</code>: <a href="#Window%20Layout">Window Layout</a>
17082
<li><code>Writing into executable and core files</code>: <a href="#Patching">Patching</a>
17083
<li><code>XDB Console</code>: <a href="#View%20Menu">View Menu</a>
17084
<li><code>XDB Reference</code>: <a href="#Getting%20Help">Getting Help</a>, <a href="#Help%20Menu">Help Menu</a>
17085
<li><code>XDB Settings</code>: <a href="#Edit%20Menu">Edit Menu</a>
17086
</ul>
17087
17088
<div class="node">
14528
<li><a href="#index-g_t_0028_0029-1248"><code>()</code></a>: <a href="#GDB-Argument-Commands">GDB Argument Commands</a></li>
14529
<li><a href="#index-g_t3_002dD-Lines-1109"><code>3-D Lines</code></a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
14530
<li><a href="#index-Abort-316"><code>Abort</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14531
<li><a href="#index-Abort-104"><code>Abort</code></a>: <a href="#Quitting">Quitting</a></li>
14532
<li><a href="#index-About-_0040DDD_007b_007d-427"><code>About <acronym>DDD</acronym></code></a>: <a href="#Help-Menu">Help Menu</a></li>
14533
<li><a href="#index-Align-on-Grid-387"><code>Align on Grid</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14534
<li><a href="#index-All-Signals-854"><code>All Signals</code></a>: <a href="#Signals">Signals</a></li>
14535
<li><a href="#index-Apply-335"><code>Apply</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14536
<li><a href="#index-Attach-782"><code>Attach</code></a>: <a href="#Attaching-to-a-Process">Attaching to a Process</a></li>
14537
<li><a href="#index-Attach-to-Process-783"><code>Attach to Process</code></a>: <a href="#Attaching-to-a-Process">Attaching to a Process</a></li>
14538
<li><a href="#index-Attach-to-Process-226"><code>Attach to Process</code></a>: <a href="#File-Menu">File Menu</a></li>
14539
<li><a href="#index-Auto_002dalign-Displays-on-Nearest-Grid-Point-1073"><code>Auto-align Displays on Nearest Grid Point</code></a>: <a href="#Aligning-Displays">Aligning Displays</a></li>
14540
<li><a href="#index-Automatic-Display-of-Button-Hints-546"><code>Automatic Display of Button Hints</code></a>: <a href="#Button-tips">Button tips</a></li>
14541
<li><a href="#index-Automatic-Display-of-Variable-Values-880"><code>Automatic Display of Variable Values</code></a>: <a href="#Value-Tips">Value Tips</a></li>
14542
<li><a href="#index-Backtrace-344"><code>Backtrace</code></a>: <a href="#Status-Menu">Status Menu</a></li>
14543
<li><a href="#index-Bash-Console-280"><code>Bash Console</code></a>: <a href="#View-Menu">View Menu</a></li>
14544
<li><a href="#index-Bash-Reference-532"><code>Bash Reference</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14545
<li><a href="#index-Bash-Reference-416"><code>Bash Reference</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14546
<li><a href="#index-Break-667"><code>Break</code></a>: <a href="#Setting-Breakpoints">Setting Breakpoints</a></li>
14547
<li><a href="#index-Break-446"><code>Break</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14548
<li><a href="#index-Breakpoints-353"><code>Breakpoints</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14549
<li><a href="#index-Button-1246"><code>Button</code></a>: <a href="#GDB-Simple-Commands">GDB Simple Commands</a></li>
14550
<li><a href="#index-Cache-Machine-Code-1162"><code>Cache Machine Code</code></a>: <a href="#Customizing-Machine-Code">Customizing Machine Code</a></li>
14551
<li><a href="#index-Cache-source-files-661"><code>Cache source files</code></a>: <a href="#Customizing-Source-Lookup">Customizing Source Lookup</a></li>
14552
<li><a href="#index-Change-Directory-761"><code>Change Directory</code></a>: <a href="#Working-Directory">Working Directory</a></li>
14553
<li><a href="#index-Change-Directory-229"><code>Change Directory</code></a>: <a href="#File-Menu">File Menu</a></li>
14554
<li><a href="#index-Clear-679"><code>Clear</code></a>: <a href="#Disabling-Breakpoints">Disabling Breakpoints</a></li>
14555
<li><a href="#index-Clear-670"><code>Clear</code></a>: <a href="#Deleting-Breakpoints">Deleting Breakpoints</a></li>
14556
<li><a href="#index-Clear-447"><code>Clear</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14557
<li><a href="#index-Clear-252"><code>Clear</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14558
<li><a href="#index-Clear-Line-337"><code>Clear Line</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14559
<li><a href="#index-Clear-Undo-Buffer-573"><code>Clear Undo Buffer</code></a>: <a href="#Customizing-Undo">Customizing Undo</a></li>
14560
<li><a href="#index-Clear-Window-339"><code>Clear Window</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14561
<li><a href="#index-Close-232"><code>Close</code></a>: <a href="#File-Menu">File Menu</a></li>
14562
<li><a href="#index-Close-data-window-when-deleting-last-display-980"><code>Close data window when deleting last display</code></a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
14563
<li><a href="#index-Cluster-966"><code>Cluster</code></a>: <a href="#Clustering">Clustering</a></li>
14564
<li><a href="#index-Cluster-Data-Displays-967"><code>Cluster Data Displays</code></a>: <a href="#Clustering">Clustering</a></li>
14565
<li><a href="#index-clustered-969"><code>clustered</code></a>: <a href="#Clustering">Clustering</a></li>
14566
<li><a href="#index-Color-1095"><code>Color</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
14567
<li><a href="#index-Command-1238"><code>Command</code></a>: <a href="#GDB-Simple-Commands">GDB Simple Commands</a></li>
14568
<li><a href="#index-Command-1128"><code>Command</code></a>: <a href="#Entering-Plotting-Commands">Entering Plotting Commands</a></li>
14569
<li><a href="#index-Command-History-322"><code>Command History</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14570
<li><a href="#index-Command-Tool-269"><code>Command Tool</code></a>: <a href="#View-Menu">View Menu</a></li>
14571
<li><a href="#index-Commands-321"><code>Commands</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14572
<li><a href="#index-Commands-209"><code>Commands</code></a>: <a href="#Menu-Bar">Menu Bar</a></li>
14573
<li><a href="#index-Complete-333"><code>Complete</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14574
<li><a href="#index-Cont-491"><code>Cont</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14575
<li><a href="#index-Continue-813"><code>Continue</code></a>: <a href="#Continuing-Somewhere-Else">Continuing Somewhere Else</a></li>
14576
<li><a href="#index-Continue-793"><code>Continue</code></a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
14577
<li><a href="#index-Continue-307"><code>Continue</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14578
<li><a href="#index-Continue-Automatically-when-Mouse-Pointer-is-Frozen-735"><code>Continue Automatically when Mouse Pointer is Frozen</code></a>: <a href="#Stopping-X-Programs">Stopping X Programs</a></li>
14579
<li><a href="#index-Continue-Until-Here-682"><code>Continue Until Here</code></a>: <a href="#Temporary-Breakpoints">Temporary Breakpoints</a></li>
14580
<li><a href="#index-Continue-Without-Signal-859"><code>Continue Without Signal</code></a>: <a href="#Signals">Signals</a></li>
14581
<li><a href="#index-Continue-Without-Signal-309"><code>Continue Without Signal</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14582
<li><a href="#index-Contour-1113"><code>Contour</code></a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
14583
<li><a href="#index-Copy-992"><code>Copy</code></a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
14584
<li><a href="#index-Copy-246"><code>Copy</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14585
<li><a href="#index-Ctrl_002bA-is-434"><code>Ctrl+A is</code></a>: <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a></li>
14586
<li><a href="#index-Ctrl_002bC-is-431"><code>Ctrl+C is</code></a>: <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a></li>
14587
<li><a href="#index-Cut-991"><code>Cut</code></a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
14588
<li><a href="#index-Cut-243"><code>Cut</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14589
<li><a href="#index-Data-372"><code>Data</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14590
<li><a href="#index-Data-212"><code>Data</code></a>: <a href="#Menu-Bar">Menu Bar</a></li>
14591
<li><a href="#index-Data-Scrolling-1069"><code>Data Scrolling</code></a>: <a href="#Scrolling-Data">Scrolling Data</a></li>
14592
<li><a href="#index-Data-Window-285"><code>Data Window</code></a>: <a href="#View-Menu">View Menu</a></li>
14593
<li><a href="#index-DBX-Console-274"><code>DBX Console</code></a>: <a href="#View-Menu">View Menu</a></li>
14594
<li><a href="#index-DBX-Reference-526"><code>DBX Reference</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14595
<li><a href="#index-DBX-Reference-417"><code>DBX Reference</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14596
<li><a href="#index-DBX-Settings-261"><code>DBX Settings</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14597
<li><a href="#index-g_t_0040value_007bDDD_007d-License-425"><code>DDD License</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14598
<li><a href="#index-g_t_0040value_007bDDD_007d-News-415"><code>DDD News</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14599
<li><a href="#index-g_t_0040value_007bDDD_007d-Reference-523"><code>DDD Reference</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14600
<li><a href="#index-g_t_0040value_007bDDD_007d-Reference-414"><code>DDD Reference</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14601
<li><a href="#index-g_t_0040value_007bDDD_007d-Splash-Screen-574"><code>DDD Splash Screen</code></a>: <a href="#Splash-Screen">Splash Screen</a></li>
14602
<li><a href="#index-g_t_0040value_007bDDD_007d-_0040WWW_007b_007d-Page-533"><code>DDD <acronym>WWW</acronym> Page</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14603
<li><a href="#index-g_t_0040value_007bDDD_007d-WWW-Page-426"><code>DDD WWW Page</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14604
<li><a href="#index-Debug-_0040value_007bDDD_007d-397"><code>Debug DDD</code></a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
14605
<li><a href="#index-Debugger-Reference-524"><code>Debugger Reference</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14606
<li><a href="#index-Debugger-Reference-418"><code>Debugger Reference</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14607
<li><a href="#index-Debugger-Settings-259"><code>Debugger Settings</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14608
<li><a href="#index-Debugger-Type-160"><code>Debugger Type</code></a>: <a href="#Debugger-Invocation">Debugger Invocation</a></li>
14609
<li><a href="#index-Define-Command-341"><code>Define Command</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14610
<li><a href="#index-Delete-689"><code>Delete</code></a>: <a href="#Editing-Breakpoint-Properties">Editing Breakpoint Properties</a></li>
14611
<li><a href="#index-Delete-672"><code>Delete</code></a>: <a href="#Deleting-Breakpoints">Deleting Breakpoints</a></li>
14612
<li><a href="#index-Delete-254"><code>Delete</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14613
<li><a href="#index-Delete-127"><code>Delete</code></a>: <a href="#Deleting-Sessions">Deleting Sessions</a></li>
14614
<li><a href="#index-Delete-Breakpoint-671"><code>Delete Breakpoint</code></a>: <a href="#Deleting-Breakpoints">Deleting Breakpoints</a></li>
14615
<li><a href="#index-Detach-Process-786"><code>Detach Process</code></a>: <a href="#Attaching-to-a-Process">Attaching to a Process</a></li>
14616
<li><a href="#index-Detach-Process-227"><code>Detach Process</code></a>: <a href="#File-Menu">File Menu</a></li>
14617
<li><a href="#index-Detect-Aliases-1014"><code>Detect Aliases</code></a>: <a href="#Shared-Structures">Shared Structures</a></li>
14618
<li><a href="#index-Detect-Aliases-380"><code>Detect Aliases</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14619
<li><a href="#index-Determine-Automatically-from-Arguments-161"><code>Determine Automatically from Arguments</code></a>: <a href="#Debugger-Invocation">Debugger Invocation</a></li>
14620
<li><a href="#index-Disable-687"><code>Disable</code></a>: <a href="#Editing-Breakpoint-Properties">Editing Breakpoint Properties</a></li>
14621
<li><a href="#index-Disable-677"><code>Disable</code></a>: <a href="#Disabling-Breakpoints">Disabling Breakpoints</a></li>
14622
<li><a href="#index-Disable-Breakpoint-675"><code>Disable Breakpoint</code></a>: <a href="#Disabling-Breakpoints">Disabling Breakpoints</a></li>
14623
<li><a href="#index-Disp-_002a-1011"><code>Disp *</code></a>: <a href="#Dereferencing-Pointers">Dereferencing Pointers</a></li>
14624
<li><a href="#index-Display-893"><code>Display</code></a>: <a href="#Creating-Single-Displays">Creating Single Displays</a></li>
14625
<li><a href="#index-Display-890"><code>Display</code></a>: <a href="#Display-Basics">Display Basics</a></li>
14626
<li><a href="#index-Display-454"><code>Display</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14627
<li><a href="#index-Display-_0028_0029-378"><code>Display ()</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14628
<li><a href="#index-Display-_002a-1012"><code>Display *</code></a>: <a href="#Dereferencing-Pointers">Dereferencing Pointers</a></li>
14629
<li><a href="#index-Display-_002a_0028_0029-1013"><code>Display *()</code></a>: <a href="#Dereferencing-Pointers">Dereferencing Pointers</a></li>
14630
<li><a href="#index-Display-Arguments-945"><code>Display Arguments</code></a>: <a href="#Displaying-Local-Variables">Displaying Local Variables</a></li>
14631
<li><a href="#index-Display-Arguments-384"><code>Display Arguments</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14632
<li><a href="#index-Display-Line-Numbers-364"><code>Display Line Numbers</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14633
<li><a href="#index-Display-Local-Variables-944"><code>Display Local Variables</code></a>: <a href="#Displaying-Local-Variables">Displaying Local Variables</a></li>
14634
<li><a href="#index-Display-Local-Variables-382"><code>Display Local Variables</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14635
<li><a href="#index-Display-Machine-Code-366"><code>Display Machine Code</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14636
<li><a href="#index-Display-Source-Line-Numbers-647"><code>Display Source Line Numbers</code></a>: <a href="#Customizing-Source-Appearance">Customizing Source Appearance</a></li>
14637
<li><a href="#index-Display-Two_002dDimensional-Arrays-as-Tables-1000"><code>Display Two-Dimensional Arrays as Tables</code></a>: <a href="#Arrays-as-Tables">Arrays as Tables</a></li>
14638
<li><a href="#index-Displays-373"><code>Displays</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14639
<li><a href="#index-Do-Nothing-406"><code>Do Nothing</code></a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
14640
<li><a href="#index-Down-828"><code>Down</code></a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
14641
<li><a href="#index-Down-494"><code>Down</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14642
<li><a href="#index-Down-350"><code>Down</code></a>: <a href="#Status-Menu">Status Menu</a></li>
14643
<li><a href="#index-Dump-Core-405"><code>Dump Core</code></a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
14644
<li><a href="#index-Dump-Core-Now-398"><code>Dump Core Now</code></a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
14645
<li><a href="#index-Edit-1169"><code>Edit</code></a>: <a href="#Editing-Source-Code">Editing Source Code</a></li>
14646
<li><a href="#index-Edit-497"><code>Edit</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14647
<li><a href="#index-Edit-237"><code>Edit</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14648
<li><a href="#index-Edit-206"><code>Edit</code></a>: <a href="#Menu-Bar">Menu Bar</a></li>
14649
<li><a href="#index-Edit-_003c_003c-1244"><code>Edit <<</code></a>: <a href="#GDB-Simple-Commands">GDB Simple Commands</a></li>
14650
<li><a href="#index-Edit-_003e_003e-1243"><code>Edit >></code></a>: <a href="#GDB-Simple-Commands">GDB Simple Commands</a></li>
14651
<li><a href="#index-Edit-_003e_003e-701"><code>Edit >></code></a>: <a href="#Breakpoint-Commands">Breakpoint Commands</a></li>
14652
<li><a href="#index-Edit-Buttons-1226"><code>Edit Buttons</code></a>: <a href="#Defining-Buttons">Defining Buttons</a></li>
14653
<li><a href="#index-Edit-Buttons-342"><code>Edit Buttons</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14654
<li><a href="#index-Edit-Menu-1022"><code>Edit Menu</code></a>: <a href="#Display-Shortcuts">Display Shortcuts</a></li>
14655
<li><a href="#index-Edit-Source-1170"><code>Edit Source</code></a>: <a href="#Editing-Source-Code">Editing Source Code</a></li>
14656
<li><a href="#index-Edit-Source-368"><code>Edit Source</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14657
<li><a href="#index-Edit-Sources-1171"><code>Edit Sources</code></a>: <a href="#Editing-Source-Code">Editing Source Code</a></li>
14658
<li><a href="#index-Edit-Themes-1049"><code>Edit Themes</code></a>: <a href="#Editing-Themes">Editing Themes</a></li>
14659
<li><a href="#index-Enable-686"><code>Enable</code></a>: <a href="#Editing-Breakpoint-Properties">Editing Breakpoint Properties</a></li>
14660
<li><a href="#index-Enable-678"><code>Enable</code></a>: <a href="#Disabling-Breakpoints">Disabling Breakpoints</a></li>
14661
<li><a href="#index-Enable-Breakpoint-676"><code>Enable Breakpoint</code></a>: <a href="#Disabling-Breakpoints">Disabling Breakpoints</a></li>
14662
<li><a href="#index-Enable-supported-buttons-only-1227"><code>Enable supported buttons only</code></a>: <a href="#Defining-Buttons">Defining Buttons</a></li>
14663
<li><a href="#index-End-1242"><code>End</code></a>: <a href="#GDB-Simple-Commands">GDB Simple Commands</a></li>
14664
<li><a href="#index-End-700"><code>End</code></a>: <a href="#Breakpoint-Commands">Breakpoint Commands</a></li>
14665
<li><a href="#index-Execute-1245"><code>Execute</code></a>: <a href="#GDB-Simple-Commands">GDB Simple Commands</a></li>
14666
<li><a href="#index-Execution-Window-775"><code>Execution Window</code></a>: <a href="#Customizing-the-Execution-Window">Customizing the Execution Window</a></li>
14667
<li><a href="#index-Execution-Window-271"><code>Execution Window</code></a>: <a href="#View-Menu">View Menu</a></li>
14668
<li><a href="#index-Exit-235"><code>Exit</code></a>: <a href="#File-Menu">File Menu</a></li>
14669
<li><a href="#index-Exit-96"><code>Exit</code></a>: <a href="#Quitting">Quitting</a></li>
14670
<li><a href="#index-File-215"><code>File</code></a>: <a href="#File-Menu">File Menu</a></li>
14671
<li><a href="#index-File-205"><code>File</code></a>: <a href="#Menu-Bar">Menu Bar</a></li>
14672
<li><a href="#index-File-Name-1085"><code>File Name</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
14673
<li><a href="#index-Find-_003c_003c-623"><code>Find <<</code></a>: <a href="#Textual-Search">Textual Search</a></li>
14674
<li><a href="#index-Find-_003c_003c-_0028_0029-358"><code>Find << ()</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14675
<li><a href="#index-Find-_003e_003e-622"><code>Find >></code></a>: <a href="#Textual-Search">Textual Search</a></li>
14676
<li><a href="#index-Find-_003e_003e-442"><code>Find >></code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14677
<li><a href="#index-Find-_003e_003e-_0028_0029-356"><code>Find >> ()</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14678
<li><a href="#index-Find-Backward-327"><code>Find Backward</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14679
<li><a href="#index-Find-Case-Sensitive-362"><code>Find Case Sensitive</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14680
<li><a href="#index-Find-Forward-329"><code>Find Forward</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14681
<li><a href="#index-Find-Words-Only-624"><code>Find Words Only</code></a>: <a href="#Textual-Search">Textual Search</a></li>
14682
<li><a href="#index-Find-Words-Only-360"><code>Find Words Only</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14683
<li><a href="#index-Finish-807"><code>Finish</code></a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
14684
<li><a href="#index-Finish-490"><code>Finish</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14685
<li><a href="#index-Finish-305"><code>Finish</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14686
<li><a href="#index-GDB-Console-273"><code>GDB Console</code></a>: <a href="#View-Menu">View Menu</a></li>
14687
<li><a href="#index-GDB-Reference-525"><code>GDB Reference</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14688
<li><a href="#index-GDB-Reference-419"><code>GDB Reference</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14689
<li><a href="#index-GDB-Settings-260"><code>GDB Settings</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14690
<li><a href="#index-Get-Core-File-130"><code>Get Core File</code></a>: <a href="#Customizing-Sessions">Customizing Sessions</a></li>
14691
<li><a href="#index-GNU-Make-Console-281"><code>GNU Make Console</code></a>: <a href="#View-Menu">View Menu</a></li>
14692
<li><a href="#index-Green-background-1040"><code>Green background</code></a>: <a href="#Using-Data-Themes">Using Data Themes</a></li>
14693
<li><a href="#index-Help-517"><code>Help</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14694
<li><a href="#index-Help-408"><code>Help</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14695
<li><a href="#index-Help-214"><code>Help</code></a>: <a href="#Menu-Bar">Menu Bar</a></li>
14696
<li><a href="#index-Hide-925"><code>Hide</code></a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
14697
<li><a href="#index-Hide-462"><code>Hide</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14698
<li><a href="#index-Iconify-all-windows-at-once-602"><code>Iconify all windows at once</code></a>: <a href="#Icons">Icons</a></li>
14699
<li><a href="#index-Ignore-Count-696"><code>Ignore Count</code></a>: <a href="#Breakpoint-Ignore-Counts">Breakpoint Ignore Counts</a></li>
14700
<li><a href="#index-Include-Core-Dump-116"><code>Include Core Dump</code></a>: <a href="#Saving-Sessions">Saving Sessions</a></li>
14701
<li><a href="#index-Intel-x86-flab-gits-and-registers-1041"><code>Intel x86 flab gits and registers</code></a>: <a href="#Using-Data-Themes">Using Data Themes</a></li>
14702
<li><a href="#index-Interrupt-724"><code>Interrupt</code></a>: <a href="#Interrupting">Interrupting</a></li>
14703
<li><a href="#index-Interrupt-484"><code>Interrupt</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14704
<li><a href="#index-Interrupt-313"><code>Interrupt</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14705
<li><a href="#index-JDB-Console-277"><code>JDB Console</code></a>: <a href="#View-Menu">View Menu</a></li>
14706
<li><a href="#index-JDB-Reference-529"><code>JDB Reference</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14707
<li><a href="#index-JDB-Reference-420"><code>JDB Reference</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14708
<li><a href="#index-JDB-Settings-264"><code>JDB Settings</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14709
<li><a href="#index-Kill-864"><code>Kill</code></a>: <a href="#Killing-the-Program">Killing the Program</a></li>
14710
<li><a href="#index-Kill-492"><code>Kill</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14711
<li><a href="#index-Kill-311"><code>Kill</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14712
<li><a href="#index-Ladebug-Console-275"><code>Ladebug Console</code></a>: <a href="#View-Menu">View Menu</a></li>
14713
<li><a href="#index-Ladebug-Reference-527"><code>Ladebug Reference</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14714
<li><a href="#index-Ladebug-Reference-421"><code>Ladebug Reference</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14715
<li><a href="#index-Ladebug-Settings-262"><code>Ladebug Settings</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14716
<li><a href="#index-Landscape-1125"><code>Landscape</code></a>: <a href="#Printing-Plots">Printing Plots</a></li>
14717
<li><a href="#index-Layout-Graph-1074"><code>Layout Graph</code></a>: <a href="#Automatic-Layout">Automatic Layout</a></li>
14718
<li><a href="#index-Layout-Graph-391"><code>Layout Graph</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14719
<li><a href="#index-Left-to-right-960"><code>Left to right</code></a>: <a href="#Placement">Placement</a></li>
14720
<li><a href="#index-List-Processes-787"><code>List Processes</code></a>: <a href="#Attaching-to-a-Process">Attaching to a Process</a></li>
14721
<li><a href="#index-Lookup-685"><code>Lookup</code></a>: <a href="#Editing-Breakpoint-Properties">Editing Breakpoint Properties</a></li>
14722
<li><a href="#index-Lookup-621"><code>Lookup</code></a>: <a href="#Looking-up-Definitions">Looking up Definitions</a></li>
14723
<li><a href="#index-Lookup-440"><code>Lookup</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14724
<li><a href="#index-Lookup-_0028_0029-354"><code>Lookup ()</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14725
<li><a href="#index-Machine-Code-Indentation-1164"><code>Machine Code Indentation</code></a>: <a href="#Customizing-Machine-Code">Customizing Machine Code</a></li>
14726
<li><a href="#index-Machine-Code-Window-287"><code>Machine Code Window</code></a>: <a href="#View-Menu">View Menu</a></li>
14727
<li><a href="#index-Maintenance-395"><code>Maintenance</code></a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
14728
<li><a href="#index-Maintenance-213"><code>Maintenance</code></a>: <a href="#Menu-Bar">Menu Bar</a></li>
14729
<li><a href="#index-Make-1189"><code>Make</code></a>: <a href="#Recompiling">Recompiling</a></li>
14730
<li><a href="#index-Make-498"><code>Make</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14731
<li><a href="#index-Make-230"><code>Make</code></a>: <a href="#File-Menu">File Menu</a></li>
14732
<li><a href="#index-Memory-1150"><code>Memory</code></a>: <a href="#Examining-Memory">Examining Memory</a></li>
14733
<li><a href="#index-Memory-375"><code>Memory</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14734
<li><a href="#index-New-Display-1023"><code>New Display</code></a>: <a href="#Display-Shortcuts">Display Shortcuts</a></li>
14735
<li><a href="#index-New-Game-402"><code>New Game</code></a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
14736
<li><a href="#index-Next-799"><code>Next</code></a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
14737
<li><a href="#index-Next-487"><code>Next</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14738
<li><a href="#index-Next-325"><code>Next</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14739
<li><a href="#index-Next-299"><code>Next</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14740
<li><a href="#index-Next-Instruction-1157"><code>Next Instruction</code></a>: <a href="#Machine-Code-Execution">Machine Code Execution</a></li>
14741
<li><a href="#index-Next-Instruction-301"><code>Next Instruction</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14742
<li><a href="#index-Nexti-1156"><code>Nexti</code></a>: <a href="#Machine-Code-Execution">Machine Code Execution</a></li>
14743
<li><a href="#index-Nexti-488"><code>Nexti</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14744
<li><a href="#index-On-item-410"><code>On item</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14745
<li><a href="#index-Open-620"><code>Open</code></a>: <a href="#Opening-Source-Files">Opening Source Files</a></li>
14746
<li><a href="#index-Open-617"><code>Open</code></a>: <a href="#Opening-Core-Dumps">Opening Core Dumps</a></li>
14747
<li><a href="#index-Open-613"><code>Open</code></a>: <a href="#Opening-Programs">Opening Programs</a></li>
14748
<li><a href="#index-Open-Class-614"><code>Open Class</code></a>: <a href="#Opening-Programs">Opening Programs</a></li>
14749
<li><a href="#index-Open-Class-218"><code>Open Class</code></a>: <a href="#File-Menu">File Menu</a></li>
14750
<li><a href="#index-Open-Core-Dump-220"><code>Open Core Dump</code></a>: <a href="#File-Menu">File Menu</a></li>
14751
<li><a href="#index-Open-Program-785"><code>Open Program</code></a>: <a href="#Attaching-to-a-Process">Attaching to a Process</a></li>
14752
<li><a href="#index-Open-Program-612"><code>Open Program</code></a>: <a href="#Opening-Programs">Opening Programs</a></li>
14753
<li><a href="#index-Open-Program-217"><code>Open Program</code></a>: <a href="#File-Menu">File Menu</a></li>
14754
<li><a href="#index-Open-Recent-615"><code>Open Recent</code></a>: <a href="#Opening-Programs">Opening Programs</a></li>
14755
<li><a href="#index-Open-Recent-219"><code>Open Recent</code></a>: <a href="#File-Menu">File Menu</a></li>
14756
<li><a href="#index-Open-Session-222"><code>Open Session</code></a>: <a href="#File-Menu">File Menu</a></li>
14757
<li><a href="#index-Open-Session-121"><code>Open Session</code></a>: <a href="#Resuming-Sessions">Resuming Sessions</a></li>
14758
<li><a href="#index-Open-Source-619"><code>Open Source</code></a>: <a href="#Opening-Source-Files">Opening Source Files</a></li>
14759
<li><a href="#index-Open-Source-221"><code>Open Source</code></a>: <a href="#File-Menu">File Menu</a></li>
14760
<li><a href="#index-Orientation-1096"><code>Orientation</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
14761
<li><a href="#index-Other-1021"><code>Other</code></a>: <a href="#Display-Shortcuts">Display Shortcuts</a></li>
14762
<li><a href="#index-Overview-409"><code>Overview</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14763
<li><a href="#index-Paper-Size-1126"><code>Paper Size</code></a>: <a href="#Printing-Plots">Printing Plots</a></li>
14764
<li><a href="#index-Paper-Size-1097"><code>Paper Size</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
14765
<li><a href="#index-Pass-853"><code>Pass</code></a>: <a href="#Signals">Signals</a></li>
14766
<li><a href="#index-Paste-993"><code>Paste</code></a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
14767
<li><a href="#index-Paste-249"><code>Paste</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14768
<li><a href="#index-Perl-Console-279"><code>Perl Console</code></a>: <a href="#View-Menu">View Menu</a></li>
14769
<li><a href="#index-Perl-Reference-531"><code>Perl Reference</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14770
<li><a href="#index-Perl-Reference-422"><code>Perl Reference</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14771
<li><a href="#index-Perl-Settings-266"><code>Perl Settings</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14772
<li><a href="#index-Placement-970"><code>Placement</code></a>: <a href="#Clustering">Clustering</a></li>
14773
<li><a href="#index-Placement-962"><code>Placement</code></a>: <a href="#Placement">Placement</a></li>
14774
<li><a href="#index-Plot-1138"><code>Plot</code></a>: <a href="#Gnuplot-Invocation">Gnuplot Invocation</a></li>
14775
<li><a href="#index-Plot-1108"><code>Plot</code></a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
14776
<li><a href="#index-Plot-458"><code>Plot</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14777
<li><a href="#index-Plot-Window-1140"><code>Plot Window</code></a>: <a href="#Gnuplot-Invocation">Gnuplot Invocation</a></li>
14778
<li><a href="#index-Portrait-1124"><code>Portrait</code></a>: <a href="#Printing-Plots">Printing Plots</a></li>
14779
<li><a href="#index-Preferences-258"><code>Preferences</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14780
<li><a href="#index-Previous-323"><code>Previous</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14781
<li><a href="#index-Print-883"><code>Print</code></a>: <a href="#Printing-Values">Printing Values</a></li>
14782
<li><a href="#index-Print-852"><code>Print</code></a>: <a href="#Signals">Signals</a></li>
14783
<li><a href="#index-Print-722"><code>Print</code></a>: <a href="#Editing-all-Watchpoints">Editing all Watchpoints</a></li>
14784
<li><a href="#index-Print-720"><code>Print</code></a>: <a href="#Editing-Watchpoint-Properties">Editing Watchpoint Properties</a></li>
14785
<li><a href="#index-Print-451"><code>Print</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14786
<li><a href="#index-Print-_0028_0029-376"><code>Print ()</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14787
<li><a href="#index-Print-Command-1084"><code>Print Command</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
14788
<li><a href="#index-Print-Graph-1083"><code>Print Graph</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
14789
<li><a href="#index-Print-Graph-228"><code>Print Graph</code></a>: <a href="#File-Menu">File Menu</a></li>
14790
<li><a href="#index-Print-Plot-1123"><code>Print Plot</code></a>: <a href="#Printing-Plots">Printing Plots</a></li>
14791
<li><a href="#index-Program-289"><code>Program</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14792
<li><a href="#index-Program-208"><code>Program</code></a>: <a href="#Menu-Bar">Menu Bar</a></li>
14793
<li><a href="#index-PYDB-Console-278"><code>PYDB Console</code></a>: <a href="#View-Menu">View Menu</a></li>
14794
<li><a href="#index-PYDB-Reference-530"><code>PYDB Reference</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14795
<li><a href="#index-PYDB-Reference-423"><code>PYDB Reference</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14796
<li><a href="#index-PYDB-Settings-265"><code>PYDB Settings</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14797
<li><a href="#index-Quit-Search-331"><code>Quit Search</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14798
<li><a href="#index-Record-1239"><code>Record</code></a>: <a href="#GDB-Simple-Commands">GDB Simple Commands</a></li>
14799
<li><a href="#index-Record-699"><code>Record</code></a>: <a href="#Breakpoint-Commands">Breakpoint Commands</a></li>
14800
<li><a href="#index-Red-Background-1043"><code>Red Background</code></a>: <a href="#Applying-Data-Themes-to-Several-Values">Applying Data Themes to Several Values</a></li>
14801
<li><a href="#index-Red-Background-1038"><code>Red Background</code></a>: <a href="#Using-Data-Themes">Using Data Themes</a></li>
14802
<li><a href="#index-Redo-840"><code>Redo</code></a>: <a href="#Undoing-Program-Execution">Undoing Program Execution</a></li>
14803
<li><a href="#index-Redo-626"><code>Redo</code></a>: <a href="#Looking-up-Previous-Locations">Looking up Previous Locations</a></li>
14804
<li><a href="#index-Redo-537"><code>Redo</code></a>: <a href="#Undo-and-Redo">Undo and Redo</a></li>
14805
<li><a href="#index-Redo-496"><code>Redo</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14806
<li><a href="#index-Redo-241"><code>Redo</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14807
<li><a href="#index-Refer-to-Program-Sources-659"><code>Refer to Program Sources</code></a>: <a href="#Customizing-Source-Lookup">Customizing Source Lookup</a></li>
14808
<li><a href="#index-Refresh-393"><code>Refresh</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14809
<li><a href="#index-Refresh-Displays-998"><code>Refresh Displays</code></a>: <a href="#Repeated-Values">Repeated Values</a></li>
14810
<li><a href="#index-Refresh-Displays-955"><code>Refresh Displays</code></a>: <a href="#Refreshing-the-Data-Window">Refreshing the Data Window</a></li>
14811
<li><a href="#index-Registers-1160"><code>Registers</code></a>: <a href="#Registers">Registers</a></li>
14812
<li><a href="#index-Registers-345"><code>Registers</code></a>: <a href="#Status-Menu">Status Menu</a></li>
14813
<li><a href="#index-Reload-Source-1174"><code>Reload Source</code></a>: <a href="#Editing-Source-Code">Editing Source Code</a></li>
14814
<li><a href="#index-Reload-Source-370"><code>Reload Source</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14815
<li><a href="#index-Remove-Menu-407"><code>Remove Menu</code></a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
14816
<li><a href="#index-Reset-856"><code>Reset</code></a>: <a href="#Signals">Signals</a></li>
14817
<li><a href="#index-Restart-234"><code>Restart</code></a>: <a href="#File-Menu">File Menu</a></li>
14818
<li><a href="#index-Rotate-465"><code>Rotate</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14819
<li><a href="#index-Rotate-Graph-1080"><code>Rotate Graph</code></a>: <a href="#Rotating-the-Graph">Rotating the Graph</a></li>
14820
<li><a href="#index-Rotate-Graph-389"><code>Rotate Graph</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14821
<li><a href="#index-Run-746"><code>Run</code></a>: <a href="#Starting-Program-Execution">Starting Program Execution</a></li>
14822
<li><a href="#index-Run-483"><code>Run</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14823
<li><a href="#index-Run-290"><code>Run</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14824
<li><a href="#index-Run-Again-749"><code>Run Again</code></a>: <a href="#Starting-Program-Execution">Starting Program Execution</a></li>
14825
<li><a href="#index-Run-Again-292"><code>Run Again</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14826
<li><a href="#index-Run-in-Execution-Window-773"><code>Run in Execution Window</code></a>: <a href="#Using-the-Execution-Window">Using the Execution Window</a></li>
14827
<li><a href="#index-Run-in-Execution-Window-294"><code>Run in Execution Window</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14828
<li><a href="#index-Save-Data-As-1134"><code>Save Data As</code></a>: <a href="#Exporting-Plot-Data">Exporting Plot Data</a></li>
14829
<li><a href="#index-Save-Options-860"><code>Save Options</code></a>: <a href="#Signals">Signals</a></li>
14830
<li><a href="#index-Save-Options-267"><code>Save Options</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14831
<li><a href="#index-Save-Session-As-861"><code>Save Session As</code></a>: <a href="#Signals">Signals</a></li>
14832
<li><a href="#index-Save-Session-As-224"><code>Save Session As</code></a>: <a href="#File-Menu">File Menu</a></li>
14833
<li><a href="#index-Save-Session-As-114"><code>Save Session As</code></a>: <a href="#Saving-Sessions">Saving Sessions</a></li>
14834
<li><a href="#index-Scale-1111"><code>Scale</code></a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
14835
<li><a href="#index-Search-path-for-source-files-634"><code>Search path for source files</code></a>: <a href="#Source-Path">Source Path</a></li>
14836
<li><a href="#index-Select-All-255"><code>Select All</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14837
<li><a href="#index-Selected-Only-1127"><code>Selected Only</code></a>: <a href="#Printing-Plots">Printing Plots</a></li>
14838
<li><a href="#index-Selected-Only-1094"><code>Selected Only</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
14839
<li><a href="#index-Send-858"><code>Send</code></a>: <a href="#Signals">Signals</a></li>
14840
<li><a href="#index-Set-1005"><code>Set</code></a>: <a href="#Assignment">Assignment</a></li>
14841
<li><a href="#index-Set-468"><code>Set</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14842
<li><a href="#index-Set-Execution-Position-811"><code>Set Execution Position</code></a>: <a href="#Continuing-Somewhere-Else">Continuing Somewhere Else</a></li>
14843
<li><a href="#index-Set-Temporary-Breakpoint-681"><code>Set Temporary Breakpoint</code></a>: <a href="#Temporary-Breakpoints">Temporary Breakpoints</a></li>
14844
<li><a href="#index-Set-Value-1006"><code>Set Value</code></a>: <a href="#Assignment">Assignment</a></li>
14845
<li><a href="#index-Show-921"><code>Show</code></a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
14846
<li><a href="#index-Show-461"><code>Show</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14847
<li><a href="#index-Show-All-931"><code>Show All</code></a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
14848
<li><a href="#index-Show-Just-930"><code>Show Just</code></a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
14849
<li><a href="#index-Show-More-929"><code>Show More</code></a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
14850
<li><a href="#index-Show-Position-and-Breakpoints-639"><code>Show Position and Breakpoints</code></a>: <a href="#Customizing-Glyphs">Customizing Glyphs</a></li>
14851
<li><a href="#index-Signals-850"><code>Signals</code></a>: <a href="#Signals">Signals</a></li>
14852
<li><a href="#index-Signals-347"><code>Signals</code></a>: <a href="#Status-Menu">Status Menu</a></li>
14853
<li><a href="#index-Small-Titles-1034"><code>Small Titles</code></a>: <a href="#Using-Data-Themes">Using Data Themes</a></li>
14854
<li><a href="#index-Small-Values-1035"><code>Small Values</code></a>: <a href="#Using-Data-Themes">Using Data Themes</a></li>
14855
<li><a href="#index-Source-352"><code>Source</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14856
<li><a href="#index-Source-211"><code>Source</code></a>: <a href="#Menu-Bar">Menu Bar</a></li>
14857
<li><a href="#index-Source-indentation-650"><code>Source indentation</code></a>: <a href="#Customizing-Source-Appearance">Customizing Source Appearance</a></li>
14858
<li><a href="#index-Source-Window-283"><code>Source Window</code></a>: <a href="#View-Menu">View Menu</a></li>
14859
<li><a href="#index-Status-343"><code>Status</code></a>: <a href="#Status-Menu">Status Menu</a></li>
14860
<li><a href="#index-Status-210"><code>Status</code></a>: <a href="#Menu-Bar">Menu Bar</a></li>
14861
<li><a href="#index-Status-Displays-950"><code>Status Displays</code></a>: <a href="#Displaying-Program-Status">Displaying Program Status</a></li>
14862
<li><a href="#index-Status-Displays-386"><code>Status Displays</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14863
<li><a href="#index-Step-796"><code>Step</code></a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
14864
<li><a href="#index-Step-485"><code>Step</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14865
<li><a href="#index-Step-295"><code>Step</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14866
<li><a href="#index-Step-Instruction-1154"><code>Step Instruction</code></a>: <a href="#Machine-Code-Execution">Machine Code Execution</a></li>
14867
<li><a href="#index-Step-Instruction-297"><code>Step Instruction</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14868
<li><a href="#index-Stepi-1153"><code>Stepi</code></a>: <a href="#Machine-Code-Execution">Machine Code Execution</a></li>
14869
<li><a href="#index-Stepi-486"><code>Stepi</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14870
<li><a href="#index-Stop-851"><code>Stop</code></a>: <a href="#Signals">Signals</a></li>
14871
<li><a href="#index-Suppress-Values-1037"><code>Suppress Values</code></a>: <a href="#Using-Data-Themes">Using Data Themes</a></li>
14872
<li><a href="#index-Suppress-Values-979"><code>Suppress Values</code></a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
14873
<li><a href="#index-Suppress-X-warnings-92"><code>Suppress X warnings</code></a>: <a href="#X-Warnings">X Warnings</a></li>
14874
<li><a href="#index-Tab-Width-655"><code>Tab Width</code></a>: <a href="#Customizing-Source-Appearance">Customizing Source Appearance</a></li>
14875
<li><a href="#index-Temp-688"><code>Temp</code></a>: <a href="#Editing-Breakpoint-Properties">Editing Breakpoint Properties</a></li>
14876
<li><a href="#index-Theme-1042"><code>Theme</code></a>: <a href="#Using-Data-Themes">Using Data Themes</a></li>
14877
<li><a href="#index-Themes-1048"><code>Themes</code></a>: <a href="#Editing-Themes">Editing Themes</a></li>
14878
<li><a href="#index-Threads-843"><code>Threads</code></a>: <a href="#Threads">Threads</a></li>
14879
<li><a href="#index-Threads-346"><code>Threads</code></a>: <a href="#Status-Menu">Status Menu</a></li>
14880
<li><a href="#index-Threshold-for-repeated-print-elements-997"><code>Threshold for repeated print elements</code></a>: <a href="#Repeated-Values">Repeated Values</a></li>
14881
<li><a href="#index-Tic-Tac-Toe-400"><code>Tic Tac Toe</code></a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
14882
<li><a href="#index-Tiny-Values-1036"><code>Tiny Values</code></a>: <a href="#Using-Data-Themes">Using Data Themes</a></li>
14883
<li><a href="#index-Tip-of-the-Day-413"><code>Tip of the Day</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14884
<li><a href="#index-Tool-Bar-Appearance-580"><code>Tool Bar Appearance</code></a>: <a href="#Window-Layout">Window Layout</a></li>
14885
<li><a href="#index-Tool-Buttons-Location-499"><code>Tool Buttons Location</code></a>: <a href="#Disabling-the-Command-Tool">Disabling the Command Tool</a></li>
14886
<li><a href="#index-Top-to-bottom-961"><code>Top to bottom</code></a>: <a href="#Placement">Placement</a></li>
14887
<li><a href="#index-Uncluster-968"><code>Uncluster</code></a>: <a href="#Clustering">Clustering</a></li>
14888
<li><a href="#index-Uncompress-554"><code>Uncompress</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
14889
<li><a href="#index-Undisp-974"><code>Undisp</code></a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
14890
<li><a href="#index-Undisp-472"><code>Undisp</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14891
<li><a href="#index-Undisplay-891"><code>Undisplay</code></a>: <a href="#Display-Basics">Display Basics</a></li>
14892
<li><a href="#index-Undo-981"><code>Undo</code></a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
14893
<li><a href="#index-Undo-939"><code>Undo</code></a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
14894
<li><a href="#index-Undo-839"><code>Undo</code></a>: <a href="#Undoing-Program-Execution">Undoing Program Execution</a></li>
14895
<li><a href="#index-Undo-833"><code>Undo</code></a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
14896
<li><a href="#index-Undo-625"><code>Undo</code></a>: <a href="#Looking-up-Previous-Locations">Looking up Previous Locations</a></li>
14897
<li><a href="#index-Undo-535"><code>Undo</code></a>: <a href="#Undo-and-Redo">Undo and Redo</a></li>
14898
<li><a href="#index-Undo-495"><code>Undo</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14899
<li><a href="#index-Undo-239"><code>Undo</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14900
<li><a href="#index-Undo-Buffer-Size-570"><code>Undo Buffer Size</code></a>: <a href="#Customizing-Undo">Customizing Undo</a></li>
14901
<li><a href="#index-Uniconify-When-Ready-790"><code>Uniconify When Ready</code></a>: <a href="#Program-Stop">Program Stop</a></li>
14902
<li><a href="#index-Until-804"><code>Until</code></a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
14903
<li><a href="#index-Until-489"><code>Until</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14904
<li><a href="#index-Until-303"><code>Until</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14905
<li><a href="#index-Unwatch-450"><code>Unwatch</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14906
<li><a href="#index-Up-827"><code>Up</code></a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
14907
<li><a href="#index-Up-493"><code>Up</code></a>: <a href="#Command-Tool">Command Tool</a></li>
14908
<li><a href="#index-Up-348"><code>Up</code></a>: <a href="#Status-Menu">Status Menu</a></li>
14909
<li><a href="#index-View-1106"><code>View</code></a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
14910
<li><a href="#index-View-268"><code>View</code></a>: <a href="#View-Menu">View Menu</a></li>
14911
<li><a href="#index-View-207"><code>View</code></a>: <a href="#Menu-Bar">Menu Bar</a></li>
14912
<li><a href="#index-Warn-if-Multiple-_0040value_007bDDD_007d-Instances-are-Running-89"><code>Warn if Multiple DDD Instances are Running</code></a>: <a href="#Multiple-Instances">Multiple Instances</a></li>
14913
<li><a href="#index-Watch-719"><code>Watch</code></a>: <a href="#Editing-Watchpoint-Properties">Editing Watchpoint Properties</a></li>
14914
<li><a href="#index-Watch-716"><code>Watch</code></a>: <a href="#Setting-Watchpoints">Setting Watchpoints</a></li>
14915
<li><a href="#index-Watch-449"><code>Watch</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
14916
<li><a href="#index-Watchpoints-374"><code>Watchpoints</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14917
<li><a href="#index-Web-Browser-559"><code>Web Browser</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
14918
<li><a href="#index-What-Now_003f-520"><code>What Now?</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14919
<li><a href="#index-What-Now_003f-412"><code>What Now?</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14920
<li><a href="#index-When-_0040value_007bDDD_007d-Crashes-403"><code>When DDD Crashes</code></a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
14921
<li><a href="#index-Window-Layout-577"><code>Window Layout</code></a>: <a href="#Window-Layout">Window Layout</a></li>
14922
<li><a href="#index-Writing-into-executable-and-core-files-1195"><code>Writing into executable and core files</code></a>: <a href="#Patching">Patching</a></li>
14923
<li><a href="#index-XDB-Console-276"><code>XDB Console</code></a>: <a href="#View-Menu">View Menu</a></li>
14924
<li><a href="#index-XDB-Reference-528"><code>XDB Reference</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14925
<li><a href="#index-XDB-Reference-424"><code>XDB Reference</code></a>: <a href="#Help-Menu">Help Menu</a></li>
14926
<li><a href="#index-XDB-Settings-263"><code>XDB Settings</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14927
</ul><div class="node">
17089
14928
<p><hr>
17090
<small class=header>
17091
Node:<a name="Key%20Index">Key Index</a>,
17092
Next:<a rel="next" accesskey="n" href="#Command%20Index">Command Index</a>,
17093
Previous:<a rel="previous" accesskey="p" href="#Label%20Index">Label Index</a>,
17094
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
14929
<a name="Key-Index"></a>
14930
Next: <a rel="next" accesskey="n" href="#Command-Index">Command Index</a>,
14931
Previous: <a rel="previous" accesskey="p" href="#Label-Index">Label Index</a>,
14932
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
17095
14933
</small>
17096
14934
17097
<br>
14935
17098
14936
</div>
17099
14937
17100
14938
<h2 class="unnumbered">Key Index</h2>
17101
14939
14940
14941
17102
14942
<ul class="index-ky" compact>
17103
<li><code>Alt+1</code>: <a href="#View%20Menu">View Menu</a>
17104
<li><code>Alt+2</code>: <a href="#View%20Menu">View Menu</a>
17105
<li><code>Alt+3</code>: <a href="#View%20Menu">View Menu</a>
17106
<li><code>Alt+4</code>: <a href="#Source%20Menu">Source Menu</a>, <a href="#View%20Menu">View Menu</a>
17107
<li><code>Alt+8</code>: <a href="#View%20Menu">View Menu</a>
17108
<li><code>Alt+9</code>: <a href="#View%20Menu">View Menu</a>
17109
<li><code>Alt+A</code>: <a href="#Data%20Menu">Data Menu</a>
17110
<li><code>Alt+G</code>: <a href="#Data%20Menu">Data Menu</a>
17111
<li><code>Alt+I</code>: <a href="#Source%20Menu">Source Menu</a>
17112
<li><code>Alt+L</code>: <a href="#Data%20Menu">Data Menu</a>
17113
<li><code>Alt+N</code>: <a href="#Source%20Menu">Source Menu</a>
17114
<li><code>Alt+R</code>: <a href="#Data%20Menu">Data Menu</a>
17115
<li><code>Alt+U</code>: <a href="#Data%20Menu">Data Menu</a>
17116
<li><code>Alt+W</code>: <a href="#Source%20Menu">Source Menu</a>
17117
<li><code>Alt+Y</code>: <a href="#Data%20Menu">Data Menu</a>
17118
<li><code>Ctrl+,</code>: <a href="#Source%20Menu">Source Menu</a>
17119
<li><code>Ctrl+-</code>: <a href="#Data%20Menu">Data Menu</a>
17120
<li><code>Ctrl+.</code>: <a href="#Source%20Menu">Source Menu</a>
17121
<li><code>Ctrl+/</code>: <a href="#Source%20Menu">Source Menu</a>
17122
<li><code>Ctrl+=</code>: <a href="#Data%20Menu">Data Menu</a>
17123
<li><code>Ctrl+\</code>: <a href="#Program%20Menu">Program Menu</a>, <a href="#Quitting">Quitting</a>
17124
<li><code>Ctrl+A</code>: <a href="#Edit%20Menu">Edit Menu</a>
17125
<li><code>Ctrl+B</code>: <a href="#Command%20History">Command History</a>, <a href="#Commands%20Menu">Commands Menu</a>
17126
<li><code>Ctrl+C</code>: <a href="#Interrupting">Interrupting</a>, <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>, <a href="#Program%20Menu">Program Menu</a>, <a href="#Edit%20Menu">Edit Menu</a>, <a href="#Quitting">Quitting</a>
17127
<li><code>Ctrl+D</code>: <a href="#Quitting">Quitting</a>
17128
<li><code>Ctrl+Down</code>: <a href="#Selecting%20a%20frame">Selecting a frame</a>, <a href="#Status%20Menu">Status Menu</a>
17129
<li><code>Ctrl+F</code>: <a href="#Command%20History">Command History</a>, <a href="#Commands%20Menu">Commands Menu</a>
17130
<li><code>Ctrl+F1</code>: <a href="#Getting%20Help">Getting Help</a>
17131
<li><code>Ctrl+Ins</code>: <a href="#Edit%20Menu">Edit Menu</a>
17132
<li><code>Ctrl+L</code>: <a href="#Data%20Menu">Data Menu</a>
17133
<li><code>Ctrl+M</code>: <a href="#File%20Menu">File Menu</a>
17134
<li><code>Ctrl+N</code>: <a href="#File%20Menu">File Menu</a>
17135
<li><code>Ctrl+O</code>: <a href="#File%20Menu">File Menu</a>
17136
<li><code>Ctrl+Q</code>: <a href="#File%20Menu">File Menu</a>, <a href="#Quitting">Quitting</a>, <a href="#Invocation">Invocation</a>
17137
<li><code>Ctrl+S</code>: <a href="#File%20Menu">File Menu</a>
17138
<li><code>Ctrl+Shift+A</code>: <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>, <a href="#Edit%20Menu">Edit Menu</a>
17139
<li><code>Ctrl+U</code>: <a href="#Commands%20Menu">Commands Menu</a>, <a href="#Edit%20Menu">Edit Menu</a>
17140
<li><code>Ctrl+Up</code>: <a href="#Selecting%20a%20frame">Selecting a frame</a>, <a href="#Status%20Menu">Status Menu</a>
17141
<li><code>Ctrl+V</code>: <a href="#Edit%20Menu">Edit Menu</a>
17142
<li><code>Ctrl+W</code>: <a href="#File%20Menu">File Menu</a>
17143
<li><code>Ctrl+X</code>: <a href="#Edit%20Menu">Edit Menu</a>
17144
<li><code>Ctrl+Y</code>: <a href="#Edit%20Menu">Edit Menu</a>
17145
<li><code>Ctrl+Z</code>: <a href="#Edit%20Menu">Edit Menu</a>
17146
<li><code>Down</code>: <a href="#Command%20History">Command History</a>, <a href="#Moving%20Displays">Moving Displays</a>, <a href="#Selecting%20Displays">Selecting Displays</a>, <a href="#Commands%20Menu">Commands Menu</a>
17147
<li><code>ESC</code>: <a href="#Command%20History">Command History</a>, <a href="#Interrupting">Interrupting</a>, <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>
17148
<li><code>Esc</code>: <a href="#Commands%20Menu">Commands Menu</a>, <a href="#Program%20Menu">Program Menu</a>
17149
<li><code>ESC</code>: <a href="#Quitting">Quitting</a>
17150
<li><code>F1</code>: <a href="#Getting%20Help">Getting Help</a>
17151
<li><code>F12</code>: <a href="#Maintenance%20Menu">Maintenance Menu</a>
17152
<li><code>F2</code>: <a href="#Program%20Menu">Program Menu</a>
17153
<li><code>F3</code>: <a href="#Program%20Menu">Program Menu</a>
17154
<li><code>F4</code>: <a href="#Program%20Menu">Program Menu</a>
17155
<li><code>F5</code>: <a href="#Program%20Menu">Program Menu</a>
17156
<li><code>F6</code>: <a href="#Program%20Menu">Program Menu</a>
17157
<li><code>F7</code>: <a href="#Program%20Menu">Program Menu</a>
17158
<li><code>F8</code>: <a href="#Program%20Menu">Program Menu</a>
17159
<li><code>F9</code>: <a href="#Program%20Menu">Program Menu</a>
17160
<li><code>Home</code>: <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>
17161
<li><code>Left</code>: <a href="#Moving%20Displays">Moving Displays</a>, <a href="#Selecting%20Displays">Selecting Displays</a>
17162
<li><code>Return</code>: <a href="#Command%20History">Command History</a>, <a href="#Commands%20Menu">Commands Menu</a>
17163
<li><code>Right</code>: <a href="#Moving%20Displays">Moving Displays</a>, <a href="#Selecting%20Displays">Selecting Displays</a>
17164
<li><code>Shift</code>: <a href="#Selecting%20Displays">Selecting Displays</a>
17165
<li><code>Shift+Ctrl+L</code>: <a href="#Source%20Menu">Source Menu</a>
17166
<li><code>Shift+Ctrl+U</code>: <a href="#Commands%20Menu">Commands Menu</a>
17167
<li><code>Shift+Ctrl+V</code>: <a href="#Source%20Menu">Source Menu</a>
17168
<li><code>Shift+Del</code>: <a href="#Edit%20Menu">Edit Menu</a>
17169
<li><code>Shift+F5</code>: <a href="#Program%20Menu">Program Menu</a>
17170
<li><code>Shift+F6</code>: <a href="#Program%20Menu">Program Menu</a>
17171
<li><code>Shift+F9</code>: <a href="#Program%20Menu">Program Menu</a>
17172
<li><code>Shift+Ins</code>: <a href="#Edit%20Menu">Edit Menu</a>
17173
<li><code>TAB</code>: <a href="#Tool%20Bar">Tool Bar</a>
17174
<li><code>Tab</code>: <a href="#Commands%20Menu">Commands Menu</a>
17175
<li><code>Up</code>: <a href="#Command%20History">Command History</a>, <a href="#Moving%20Displays">Moving Displays</a>, <a href="#Selecting%20Displays">Selecting Displays</a>, <a href="#Commands%20Menu">Commands Menu</a>
17176
</ul>
17177
17178
<div class="node">
14943
<li><a href="#index-Alt_002b1-282"><code>Alt+1</code></a>: <a href="#View-Menu">View Menu</a></li>
14944
<li><a href="#index-Alt_002b2-284"><code>Alt+2</code></a>: <a href="#View-Menu">View Menu</a></li>
14945
<li><a href="#index-Alt_002b3-286"><code>Alt+3</code></a>: <a href="#View-Menu">View Menu</a></li>
14946
<li><a href="#index-Alt_002b4-367"><code>Alt+4</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14947
<li><a href="#index-Alt_002b4-288"><code>Alt+4</code></a>: <a href="#View-Menu">View Menu</a></li>
14948
<li><a href="#index-Alt_002b8-270"><code>Alt+8</code></a>: <a href="#View-Menu">View Menu</a></li>
14949
<li><a href="#index-Alt_002b9-272"><code>Alt+9</code></a>: <a href="#View-Menu">View Menu</a></li>
14950
<li><a href="#index-Alt_002bA-381"><code>Alt+A</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14951
<li><a href="#index-Alt_002bG-388"><code>Alt+G</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14952
<li><a href="#index-Alt_002bI-363"><code>Alt+I</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14953
<li><a href="#index-Alt_002bL-383"><code>Alt+L</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14954
<li><a href="#index-Alt_002bN-365"><code>Alt+N</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14955
<li><a href="#index-Alt_002bR-390"><code>Alt+R</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14956
<li><a href="#index-Alt_002bU-385"><code>Alt+U</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14957
<li><a href="#index-Alt_002bW-361"><code>Alt+W</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14958
<li><a href="#index-Alt_002bY-392"><code>Alt+Y</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14959
<li><a href="#index-Ctrl_002b_002c-359"><code>Ctrl+,</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14960
<li><a href="#index-Ctrl_002b_002d-379"><code>Ctrl+-</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14961
<li><a href="#index-Ctrl_002b_002e-357"><code>Ctrl+.</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14962
<li><a href="#index-Ctrl_002b_002f-355"><code>Ctrl+/</code></a>: <a href="#Source-Menu">Source Menu</a></li>
14963
<li><a href="#index-Ctrl_002b_003d-377"><code>Ctrl+=</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14964
<li><a href="#index-Ctrl_002b_005c-320"><code>Ctrl+\</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14965
<li><a href="#index-Ctrl_002b_005c-103"><code>Ctrl+\</code></a>: <a href="#Quitting">Quitting</a></li>
14966
<li><a href="#index-Ctrl_002bA-256"><code>Ctrl+A</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14967
<li><a href="#index-Ctrl_002bB-1208"><code>Ctrl+B</code></a>: <a href="#Command-History">Command History</a></li>
14968
<li><a href="#index-Ctrl_002bB-328"><code>Ctrl+B</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14969
<li><a href="#index-Ctrl_002bC-726"><code>Ctrl+C</code></a>: <a href="#Interrupting">Interrupting</a></li>
14970
<li><a href="#index-Ctrl_002bC-430"><code>Ctrl+C</code></a>: <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a></li>
14971
<li><a href="#index-Ctrl_002bC-315"><code>Ctrl+C</code></a>: <a href="#Program-Menu">Program Menu</a></li>
14972
<li><a href="#index-Ctrl_002bC-247"><code>Ctrl+C</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14973
<li><a href="#index-Ctrl_002bC-108"><code>Ctrl+C</code></a>: <a href="#Quitting">Quitting</a></li>
14974
<li><a href="#index-Ctrl_002bD-94"><code>Ctrl+D</code></a>: <a href="#Quitting">Quitting</a></li>
14975
<li><a href="#index-Ctrl_002bDown-832"><code>Ctrl+Down</code></a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
14976
<li><a href="#index-Ctrl_002bDown-351"><code>Ctrl+Down</code></a>: <a href="#Status-Menu">Status Menu</a></li>
14977
<li><a href="#index-Ctrl_002bF-1209"><code>Ctrl+F</code></a>: <a href="#Command-History">Command History</a></li>
14978
<li><a href="#index-Ctrl_002bF-330"><code>Ctrl+F</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14979
<li><a href="#index-Ctrl_002bF1-521"><code>Ctrl+F1</code></a>: <a href="#Getting-Help">Getting Help</a></li>
14980
<li><a href="#index-Ctrl_002bIns-248"><code>Ctrl+Ins</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14981
<li><a href="#index-Ctrl_002bL-394"><code>Ctrl+L</code></a>: <a href="#Data-Menu">Data Menu</a></li>
14982
<li><a href="#index-Ctrl_002bM-231"><code>Ctrl+M</code></a>: <a href="#File-Menu">File Menu</a></li>
14983
<li><a href="#index-Ctrl_002bN-223"><code>Ctrl+N</code></a>: <a href="#File-Menu">File Menu</a></li>
14984
<li><a href="#index-Ctrl_002bO-216"><code>Ctrl+O</code></a>: <a href="#File-Menu">File Menu</a></li>
14985
<li><a href="#index-Ctrl_002bQ-236"><code>Ctrl+Q</code></a>: <a href="#File-Menu">File Menu</a></li>
14986
<li><a href="#index-Ctrl_002bQ-95"><code>Ctrl+Q</code></a>: <a href="#Quitting">Quitting</a></li>
14987
<li><a href="#index-Ctrl_002bQ-50"><code>Ctrl+Q</code></a>: <a href="#Invocation">Invocation</a></li>
14988
<li><a href="#index-Ctrl_002bS-225"><code>Ctrl+S</code></a>: <a href="#File-Menu">File Menu</a></li>
14989
<li><a href="#index-Ctrl_002bShift_002bA-436"><code>Ctrl+Shift+A</code></a>: <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a></li>
14990
<li><a href="#index-Ctrl_002bShift_002bA-257"><code>Ctrl+Shift+A</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14991
<li><a href="#index-Ctrl_002bU-338"><code>Ctrl+U</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
14992
<li><a href="#index-Ctrl_002bU-253"><code>Ctrl+U</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14993
<li><a href="#index-Ctrl_002bUp-831"><code>Ctrl+Up</code></a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
14994
<li><a href="#index-Ctrl_002bUp-349"><code>Ctrl+Up</code></a>: <a href="#Status-Menu">Status Menu</a></li>
14995
<li><a href="#index-Ctrl_002bV-250"><code>Ctrl+V</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14996
<li><a href="#index-Ctrl_002bW-233"><code>Ctrl+W</code></a>: <a href="#File-Menu">File Menu</a></li>
14997
<li><a href="#index-Ctrl_002bX-244"><code>Ctrl+X</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14998
<li><a href="#index-Ctrl_002bY-242"><code>Ctrl+Y</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
14999
<li><a href="#index-Ctrl_002bZ-240"><code>Ctrl+Z</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
15000
<li><a href="#index-Down-1206"><code>Down</code></a>: <a href="#Command-History">Command History</a></li>
15001
<li><a href="#index-Down-1065"><code>Down</code></a>: <a href="#Moving-Displays">Moving Displays</a></li>
15002
<li><a href="#index-Down-916"><code>Down</code></a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15003
<li><a href="#index-Down-326"><code>Down</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
15004
<li><a href="#index-ESC-1210"><code>ESC</code></a>: <a href="#Command-History">Command History</a></li>
15005
<li><a href="#index-ESC-725"><code>ESC</code></a>: <a href="#Interrupting">Interrupting</a></li>
15006
<li><a href="#index-ESC-432"><code>ESC</code></a>: <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a></li>
15007
<li><a href="#index-Esc-332"><code>Esc</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
15008
<li><a href="#index-Esc-314"><code>Esc</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15009
<li><a href="#index-ESC-100"><code>ESC</code></a>: <a href="#Quitting">Quitting</a></li>
15010
<li><a href="#index-F1-516"><code>F1</code></a>: <a href="#Getting-Help">Getting Help</a></li>
15011
<li><a href="#index-F12-396"><code>F12</code></a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
15012
<li><a href="#index-F2-291"><code>F2</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15013
<li><a href="#index-F3-293"><code>F3</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15014
<li><a href="#index-F4-312"><code>F4</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15015
<li><a href="#index-F5-296"><code>F5</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15016
<li><a href="#index-F6-300"><code>F6</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15017
<li><a href="#index-F7-304"><code>F7</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15018
<li><a href="#index-F8-306"><code>F8</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15019
<li><a href="#index-F9-308"><code>F9</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15020
<li><a href="#index-Home-435"><code>Home</code></a>: <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a></li>
15021
<li><a href="#index-Left-1066"><code>Left</code></a>: <a href="#Moving-Displays">Moving Displays</a></li>
15022
<li><a href="#index-Left-917"><code>Left</code></a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15023
<li><a href="#index-Return-1207"><code>Return</code></a>: <a href="#Command-History">Command History</a></li>
15024
<li><a href="#index-Return-336"><code>Return</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
15025
<li><a href="#index-Right-1067"><code>Right</code></a>: <a href="#Moving-Displays">Moving Displays</a></li>
15026
<li><a href="#index-Right-918"><code>Right</code></a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15027
<li><a href="#index-Shift-914"><code>Shift</code></a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15028
<li><a href="#index-Shift_002bCtrl_002bL-371"><code>Shift+Ctrl+L</code></a>: <a href="#Source-Menu">Source Menu</a></li>
15029
<li><a href="#index-Shift_002bCtrl_002bU-340"><code>Shift+Ctrl+U</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
15030
<li><a href="#index-Shift_002bCtrl_002bV-369"><code>Shift+Ctrl+V</code></a>: <a href="#Source-Menu">Source Menu</a></li>
15031
<li><a href="#index-Shift_002bDel-245"><code>Shift+Del</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
15032
<li><a href="#index-Shift_002bF5-298"><code>Shift+F5</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15033
<li><a href="#index-Shift_002bF6-302"><code>Shift+F6</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15034
<li><a href="#index-Shift_002bF9-310"><code>Shift+F9</code></a>: <a href="#Program-Menu">Program Menu</a></li>
15035
<li><a href="#index-Shift_002bIns-251"><code>Shift+Ins</code></a>: <a href="#Edit-Menu">Edit Menu</a></li>
15036
<li><a href="#index-TAB-439"><code>TAB</code></a>: <a href="#Tool-Bar">Tool Bar</a></li>
15037
<li><a href="#index-Tab-334"><code>Tab</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
15038
<li><a href="#index-Up-1205"><code>Up</code></a>: <a href="#Command-History">Command History</a></li>
15039
<li><a href="#index-Up-1064"><code>Up</code></a>: <a href="#Moving-Displays">Moving Displays</a></li>
15040
<li><a href="#index-Up-915"><code>Up</code></a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15041
<li><a href="#index-Up-324"><code>Up</code></a>: <a href="#Commands-Menu">Commands Menu</a></li>
15042
</ul><div class="node">
17179
15043
<p><hr>
17180
<small class=header>
17181
Node:<a name="Command%20Index">Command Index</a>,
17182
Next:<a rel="next" accesskey="n" href="#Resource%20Index">Resource Index</a>,
17183
Previous:<a rel="previous" accesskey="p" href="#Key%20Index">Key Index</a>,
17184
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
15044
<a name="Command-Index"></a>
15045
Next: <a rel="next" accesskey="n" href="#Resource-Index">Resource Index</a>,
15046
Previous: <a rel="previous" accesskey="p" href="#Key-Index">Key Index</a>,
15047
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
17185
15048
</small>
17186
15049
17187
<br>
15050
17188
15051
</div>
17189
15052
17190
15053
<h2 class="unnumbered">Command Index</h2>
17191
15054
15055
15056
17192
15057
<ul class="index-cm" compact>
17193
<li><code>cont</code>: <a href="#Undoing%20Program%20Execution">Undoing Program Execution</a>, <a href="#Customizing%20Grab%20Checking">Customizing Grab Checking</a>
17194
<li><code>contuntil</code>: <a href="#GDB%20Argument%20Commands">GDB Argument Commands</a>
17195
<li><code>directory</code>: <a href="#Source%20Path">Source Path</a>
17196
<li><code>down</code>: <a href="#Selecting%20a%20frame">Selecting a frame</a>
17197
<li><code>file</code>: <a href="#Remote%20Program">Remote Program</a>
17198
<li><code>gcore</code>: <a href="#Customizing%20Sessions">Customizing Sessions</a>
17199
<li><code>gd</code>: <a href="#Commands%20with%20Other%20Debuggers">Commands with Other Debuggers</a>
17200
<li><code>graph apply theme</code>: <a href="#Applying%20Data%20Themes%20to%20Several%20Values">Applying Data Themes to Several Values</a>
17201
<li><code>graph disable display</code>: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17202
<li><code>graph display</code>: <a href="#Displaying%20Program%20Status">Displaying Program Status</a>, <a href="#Creating%20Single%20Displays">Creating Single Displays</a>
17203
<li><code>graph enable display</code>: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17204
<li><code>graph plot</code>: <a href="#Plotting%20Arrays">Plotting Arrays</a>
17205
<li><code>graph refresh</code>: <a href="#Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>
17206
<li><code>graph toggle theme</code>: <a href="#Applying%20Data%20Themes%20to%20Several%20Values">Applying Data Themes to Several Values</a>
17207
<li><code>graph unapply theme</code>: <a href="#Applying%20Data%20Themes%20to%20Several%20Values">Applying Data Themes to Several Values</a>
17208
<li><code>gunzip</code>: <a href="#Help%20Helpers">Help Helpers</a>
17209
<li><code>gzip</code>: <a href="#Help%20Helpers">Help Helpers</a>
17210
<li><code>hbreak</code>: <a href="#Hardware-Assisted%20Breakpoints">Hardware-Assisted Breakpoints</a>
17211
<li><code>help</code>: <a href="#Getting%20Help">Getting Help</a>
17212
<li><code>kill</code>: <a href="#Customizing%20Grab%20Checking">Customizing Grab Checking</a>
17213
<li><code>mwm</code>: <a href="#Gnuplot%20Invocation">Gnuplot Invocation</a>
17214
<li><code>print</code>: <a href="#Printing%20Values">Printing Values</a>
17215
<li><code>quit</code>: <a href="#Customizing%20Grab%20Checking">Customizing Grab Checking</a>, <a href="#Quitting">Quitting</a>
17216
<li><code>remsh</code>: <a href="#Remote%20Debugger">Remote Debugger</a>
17217
<li><code>replot</code>: <a href="#Entering%20Plotting%20Commands">Entering Plotting Commands</a>
17218
<li><code>rsh</code>: <a href="#Remote%20Debugger">Remote Debugger</a>
17219
<li><code>run</code>: <a href="#Starting%20Program%20Execution">Starting Program Execution</a>
17220
<li><code>set environment</code>: <a href="#Environment">Environment</a>
17221
<li><code>set output</code>: <a href="#Entering%20Plotting%20Commands">Entering Plotting Commands</a>
17222
<li><code>set term</code>: <a href="#Entering%20Plotting%20Commands">Entering Plotting Commands</a>
17223
<li><code>target remote</code>: <a href="#Remote%20Program">Remote Program</a>
17224
<li><code>thbreak</code>: <a href="#Hardware-Assisted%20Breakpoints">Hardware-Assisted Breakpoints</a>
17225
<li><code>tty</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17226
<li><code>unset environment</code>: <a href="#Environment">Environment</a>
17227
<li><code>up</code>: <a href="#Selecting%20a%20frame">Selecting a frame</a>
17228
<li><code>zcat</code>: <a href="#Help%20Helpers">Help Helpers</a>
17229
</ul>
17230
17231
<div class="node">
15058
<li><a href="#index-cont-841"><code>cont</code></a>: <a href="#Undoing-Program-Execution">Undoing Program Execution</a></li>
15059
<li><a href="#index-cont-739"><code>cont</code></a>: <a href="#Customizing-Grab-Checking">Customizing Grab Checking</a></li>
15060
<li><a href="#index-contuntil-1249"><code>contuntil</code></a>: <a href="#GDB-Argument-Commands">GDB Argument Commands</a></li>
15061
<li><a href="#index-directory-637"><code>directory</code></a>: <a href="#Source-Path">Source Path</a></li>
15062
<li><a href="#index-down-830"><code>down</code></a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
15063
<li><a href="#index-file-157"><code>file</code></a>: <a href="#Remote-Program">Remote Program</a></li>
15064
<li><a href="#index-gcore-131"><code>gcore</code></a>: <a href="#Customizing-Sessions">Customizing Sessions</a></li>
15065
<li><a href="#index-gd-1253"><code>gd</code></a>: <a href="#Commands-with-Other-Debuggers">Commands with Other Debuggers</a></li>
15066
<li><a href="#index-graph-apply-theme-1044"><code>graph apply theme</code></a>: <a href="#Applying-Data-Themes-to-Several-Values">Applying Data Themes to Several Values</a></li>
15067
<li><a href="#index-graph-disable-display-935"><code>graph disable display</code></a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15068
<li><a href="#index-graph-display-948"><code>graph display</code></a>: <a href="#Displaying-Program-Status">Displaying Program Status</a></li>
15069
<li><a href="#index-graph-display-895"><code>graph display</code></a>: <a href="#Creating-Single-Displays">Creating Single Displays</a></li>
15070
<li><a href="#index-graph-enable-display-936"><code>graph enable display</code></a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15071
<li><a href="#index-graph-plot-1103"><code>graph plot</code></a>: <a href="#Plotting-Arrays">Plotting Arrays</a></li>
15072
<li><a href="#index-graph-refresh-957"><code>graph refresh</code></a>: <a href="#Refreshing-the-Data-Window">Refreshing the Data Window</a></li>
15073
<li><a href="#index-graph-toggle-theme-1046"><code>graph toggle theme</code></a>: <a href="#Applying-Data-Themes-to-Several-Values">Applying Data Themes to Several Values</a></li>
15074
<li><a href="#index-graph-unapply-theme-1045"><code>graph unapply theme</code></a>: <a href="#Applying-Data-Themes-to-Several-Values">Applying Data Themes to Several Values</a></li>
15075
<li><a href="#index-gunzip-557"><code>gunzip</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15076
<li><a href="#index-gzip-556"><code>gzip</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15077
<li><a href="#index-hbreak-709"><code>hbreak</code></a>: <a href="#Hardware_002dAssisted-Breakpoints">Hardware-Assisted Breakpoints</a></li>
15078
<li><a href="#index-help-519"><code>help</code></a>: <a href="#Getting-Help">Getting Help</a></li>
15079
<li><a href="#index-kill-740"><code>kill</code></a>: <a href="#Customizing-Grab-Checking">Customizing Grab Checking</a></li>
15080
<li><a href="#index-mwm-1142"><code>mwm</code></a>: <a href="#Gnuplot-Invocation">Gnuplot Invocation</a></li>
15081
<li><a href="#index-print-884"><code>print</code></a>: <a href="#Printing-Values">Printing Values</a></li>
15082
<li><a href="#index-quit-741"><code>quit</code></a>: <a href="#Customizing-Grab-Checking">Customizing Grab Checking</a></li>
15083
<li><a href="#index-quit-99"><code>quit</code></a>: <a href="#Quitting">Quitting</a></li>
15084
<li><a href="#index-remsh-139"><code>remsh</code></a>: <a href="#Remote-Debugger">Remote Debugger</a></li>
15085
<li><a href="#index-replot-1129"><code>replot</code></a>: <a href="#Entering-Plotting-Commands">Entering Plotting Commands</a></li>
15086
<li><a href="#index-rsh-140"><code>rsh</code></a>: <a href="#Remote-Debugger">Remote Debugger</a></li>
15087
<li><a href="#index-run-747"><code>run</code></a>: <a href="#Starting-Program-Execution">Starting Program Execution</a></li>
15088
<li><a href="#index-set-environment-754"><code>set environment</code></a>: <a href="#Environment">Environment</a></li>
15089
<li><a href="#index-set-output-1130"><code>set output</code></a>: <a href="#Entering-Plotting-Commands">Entering Plotting Commands</a></li>
15090
<li><a href="#index-set-term-1131"><code>set term</code></a>: <a href="#Entering-Plotting-Commands">Entering Plotting Commands</a></li>
15091
<li><a href="#index-target-remote-158"><code>target remote</code></a>: <a href="#Remote-Program">Remote Program</a></li>
15092
<li><a href="#index-thbreak-712"><code>thbreak</code></a>: <a href="#Hardware_002dAssisted-Breakpoints">Hardware-Assisted Breakpoints</a></li>
15093
<li><a href="#index-tty-198"><code>tty</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15094
<li><a href="#index-unset-environment-753"><code>unset environment</code></a>: <a href="#Environment">Environment</a></li>
15095
<li><a href="#index-up-829"><code>up</code></a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
15096
<li><a href="#index-zcat-558"><code>zcat</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15097
</ul><div class="node">
17232
15098
<p><hr>
17233
<small class=header>
17234
Node:<a name="Resource%20Index">Resource Index</a>,
17235
Next:<a rel="next" accesskey="n" href="#File%20Index">File Index</a>,
17236
Previous:<a rel="previous" accesskey="p" href="#Command%20Index">Command Index</a>,
17237
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
15099
<a name="Resource-Index"></a>
15100
Next: <a rel="next" accesskey="n" href="#File-Index">File Index</a>,
15101
Previous: <a rel="previous" accesskey="p" href="#Command-Index">Command Index</a>,
15102
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
17238
15103
</small>
17239
15104
17240
<br>
15105
17241
15106
</div>
17242
15107
17243
15108
<h2 class="unnumbered">Resource Index</h2>
17244
15109
15110
15111
17245
15112
<ul class="index-vr" compact>
17246
<li><code>activeButtonColorKey</code>: <a href="#Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>
17247
<li><code>align2dArrays</code>: <a href="#Arrays%20as%20Tables">Arrays as Tables</a>
17248
<li><code>appDefaultsVersion</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17249
<li><code>arrayOrientation</code>: <a href="#Rotating%20Displays">Rotating Displays</a>
17250
<li><code>autoCloseDataWindow</code>: <a href="#Display%20Resources">Display Resources</a>
17251
<li><code>autoDebugger</code>: <a href="#Debugger%20Invocation">Debugger Invocation</a>
17252
<li><code>autoRaiseMenu</code>: <a href="#Auto-Raise%20Menus">Auto-Raise Menus</a>
17253
<li><code>autoRaiseMenuDelay</code>: <a href="#Auto-Raise%20Menus">Auto-Raise Menus</a>
17254
<li><code>autoRaiseTool</code>: <a href="#Customizing%20Tool%20Position">Customizing Tool Position</a>
17255
<li><code>bash</code>: <a href="#Bash%20Initialization">Bash Initialization</a>
17256
<li><code>bashDisplayShortcuts</code>: <a href="#Display%20Shortcuts">Display Shortcuts</a>
17257
<li><code>bashInitCommands</code>: <a href="#Bash%20Initialization">Bash Initialization</a>
17258
<li><code>blockTTYInput</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17259
<li><code>break_at</code>: <a href="#Images">Images</a>
17260
<li><code>bufferGDBOutput</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17261
<li><code>bumpDisplays</code>: <a href="#Display%20Resources">Display Resources</a>
17262
<li><code>buttonCaptionGeometry</code>: <a href="#Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>
17263
<li><code>buttonCaptions</code>: <a href="#Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>
17264
<li><code>buttonColorKey</code>: <a href="#Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>
17265
<li><code>buttonDocs</code>: <a href="#Button%20tips">Button tips</a>
17266
<li><code>buttonImageGeometry</code>: <a href="#Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>
17267
<li><code>buttonImages</code>: <a href="#Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>
17268
<li><code>buttonTips</code>: <a href="#Button%20tips">Button tips</a>
17269
<li><code>cacheGlyphImages</code>: <a href="#Customizing%20Glyphs">Customizing Glyphs</a>
17270
<li><code>cacheMachineCode</code>: <a href="#Customizing%20Machine%20Code">Customizing Machine Code</a>
17271
<li><code>cacheSourceFiles</code>: <a href="#Customizing%20Source%20Lookup">Customizing Source Lookup</a>
17272
<li><code>checkConfiguration</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17273
<li><code>checkGrabDelay</code>: <a href="#Customizing%20Grab%20Checking">Customizing Grab Checking</a>
17274
<li><code>checkGrabs</code>: <a href="#Customizing%20Grab%20Checking">Customizing Grab Checking</a>
17275
<li><code>checkOptions</code>: <a href="#Multiple%20Instances">Multiple Instances</a>
17276
<li><code>CLASSPATH</code>: <a href="#Source%20Path">Source Path</a>
17277
<li><code>clear_at</code>: <a href="#Images">Images</a>
17278
<li><code>clusterDisplays</code>: <a href="#Display%20Resources">Display Resources</a>
17279
<li><code>commandToolBar</code>: <a href="#Disabling%20the%20Command%20Tool">Disabling the Command Tool</a>
17280
<li><code>commonToolBar</code>: <a href="#Window%20Layout">Window Layout</a>
17281
<li><code>consoleButtons</code>: <a href="#Customizing%20Buttons">Customizing Buttons</a>
17282
<li><code>consoleHasFocus</code>: <a href="#Typing%20in%20the%20Source%20Window">Typing in the Source Window</a>
17283
<li><code>contInterruptDelay</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17284
<li><code>cutCopyPasteBindings</code>: <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>
17285
<li><code>dataButtons</code>: <a href="#Customizing%20Buttons">Customizing Buttons</a>
17286
<li><code>dataFont</code>: <a href="#Customizing%20Fonts">Customizing Fonts</a>
17287
<li><code>dataFontSize</code>: <a href="#Customizing%20Fonts">Customizing Fonts</a>
17288
<li><code>dbxDisplayShortcuts</code>: <a href="#Display%20Shortcuts">Display Shortcuts</a>
17289
<li><code>dbxInitCommands</code>: <a href="#DBX%20Initialization">DBX Initialization</a>
17290
<li><code>dbxSettings</code>: <a href="#DBX%20Initialization">DBX Initialization</a>
17291
<li><code>ddd</code>: <a href="#Images">Images</a>
17292
<li><code>DDD</code>: <a href="#Environment">Environment</a>
17293
<li><code>DDD_NO_SIGNAL_HANDLERS</code>: <a href="#Debugging%20%3csmall%3eDDD%3c%2fsmall%3e">Debugging <small>DDD</small></a>
17294
<li><code>DDD_SESSION</code>: <a href="#Resources">Resources</a>
17295
<li><code>DDD_SESSIONS</code>: <a href="#Customizing%20Sessions">Customizing Sessions</a>
17296
<li><code>DDD_STATE</code>: <a href="#Resources">Resources</a>
17297
<li><code>dddinitVersion</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17298
<li><code>debugCoreDumps</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17299
<li><code>debugger</code>: <a href="#Debugger%20Invocation">Debugger Invocation</a>
17300
<li><code>debuggerCommand</code>: <a href="#Debugger%20Invocation">Debugger Invocation</a>
17301
<li><code>decorateTool</code>: <a href="#Customizing%20Tool%20Decoration">Customizing Tool Decoration</a>
17302
<li><code>defaultFont</code>: <a href="#Customizing%20Fonts">Customizing Fonts</a>
17303
<li><code>defaultFontSize</code>: <a href="#Customizing%20Fonts">Customizing Fonts</a>
17304
<li><code>delete</code>: <a href="#Images">Images</a>
17305
<li><code>deleteAliasDisplays</code>: <a href="#Shared%20Structures">Shared Structures</a>
17306
<li><code>detectAliases</code>: <a href="#Shared%20Structures">Shared Structures</a>
17307
<li><code>disable</code>: <a href="#Images">Images</a>
17308
<li><code>disassemble</code>: <a href="#Customizing%20Machine%20Code">Customizing Machine Code</a>
17309
<li><code>display</code>: <a href="#Images">Images</a>
17310
<li><code>DISPLAY</code>: <a href="#Remote%20Host">Remote Host</a>, <a href="#X%20Options">X Options</a>
17311
<li><code>displayGlyphs</code>: <a href="#Customizing%20Glyphs">Customizing Glyphs</a>
17312
<li><code>displayLineNumbers</code>: <a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
17313
<li><code>displayPlacement</code>: <a href="#Placement">Placement</a>
17314
<li><code>displayTimeout</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17315
<li><code>dispref</code>: <a href="#Images">Images</a>
17316
<li><code>drag_arrow</code>: <a href="#Images">Images</a>
17317
<li><code>drag_cond</code>: <a href="#Images">Images</a>
17318
<li><code>drag_stop</code>: <a href="#Images">Images</a>
17319
<li><code>drag_temp</code>: <a href="#Images">Images</a>
17320
<li><code>dumpCore</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17321
<li><code>editCommand</code>: <a href="#Customizing%20Editing">Customizing Editing</a>
17322
<li><code>EDITOR</code>: <a href="#Customizing%20Editing">Customizing Editing</a>
17323
<li><code>enable</code>: <a href="#Images">Images</a>
17324
<li><code>expandRepeatedValues</code>: <a href="#Repeated%20Values">Repeated Values</a>
17325
<li><code>filterFiles</code>: <a href="#Customizing%20File%20Filtering">Customizing File Filtering</a>
17326
<li><code>find_backward</code>: <a href="#Images">Images</a>
17327
<li><code>find_forward</code>: <a href="#Images">Images</a>
17328
<li><code>findCaseSensitive</code>: <a href="#Customizing%20Searching">Customizing Searching</a>
17329
<li><code>findWordsOnly</code>: <a href="#Customizing%20Searching">Customizing Searching</a>
17330
<li><code>fixedWidthFont</code>: <a href="#Customizing%20Fonts">Customizing Fonts</a>
17331
<li><code>fixedWidthFontSize</code>: <a href="#Customizing%20Fonts">Customizing Fonts</a>
17332
<li><code>flatDialogButtons</code>: <a href="#Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>
17333
<li><code>flatToolbarButtons</code>: <a href="#Customizing%20the%20Tool%20Bar">Customizing the Tool Bar</a>
17334
<li><code>fontSelectCommand</code>: <a href="#Customizing%20Fonts">Customizing Fonts</a>
17335
<li><code>gdbDisplayShortcuts</code>: <a href="#Display%20Shortcuts">Display Shortcuts</a>
17336
<li><code>gdbInitCommands</code>: <a href="#GDB%20Initialization">GDB Initialization</a>
17337
<li><code>gdbSettings</code>: <a href="#GDB%20Initialization">GDB Initialization</a>
17338
<li><code>getCoreCommand</code>: <a href="#Customizing%20Sessions">Customizing Sessions</a>
17339
<li><code>globalTabCompletion</code>: <a href="#Command%20Completion">Command Completion</a>
17340
<li><code>glyphUpdateDelay</code>: <a href="#Customizing%20Glyphs">Customizing Glyphs</a>
17341
<li><code>grabAction</code>: <a href="#Customizing%20Grab%20Checking">Customizing Grab Checking</a>
17342
<li><code>grabActionDelay</code>: <a href="#Customizing%20Grab%20Checking">Customizing Grab Checking</a>
17343
<li><code>grey_arrow</code>: <a href="#Images">Images</a>
17344
<li><code>grey_cond</code>: <a href="#Images">Images</a>
17345
<li><code>grey_stop</code>: <a href="#Images">Images</a>
17346
<li><code>grey_temp</code>: <a href="#Images">Images</a>
17347
<li><code>groupIconify</code>: <a href="#Icons">Icons</a>
17348
<li><code>hide</code>: <a href="#Images">Images</a>
17349
<li><code>hideInactiveDisplays</code>: <a href="#Display%20Resources">Display Resources</a>
17350
<li><code>indentCode</code>: <a href="#Customizing%20Machine%20Code">Customizing Machine Code</a>
17351
<li><code>indentScript</code>: <a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
17352
<li><code>indentSource</code>: <a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
17353
<li><code>initSymbols</code>: <a href="#Finding%20a%20Place%20to%20Start">Finding a Place to Start</a>
17354
<li><code>jdbDisplayShortcuts</code>: <a href="#Display%20Shortcuts">Display Shortcuts</a>
17355
<li><code>jdbInitCommands</code>: <a href="#JDB%20Initialization">JDB Initialization</a>
17356
<li><code>jdbSettings</code>: <a href="#JDB%20Initialization">JDB Initialization</a>
17357
<li><code>labelDelimiter</code>: <a href="#Customizing%20Buttons">Customizing Buttons</a>
17358
<li><code>lessTifVersion</code>: <a href="#LessTif">LessTif</a>
17359
<li><code>lineBufferedConsole</code>: <a href="#Input%2fOutput">Input/Output</a>
17360
<li><code>lineNumberWidth</code>: <a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
17361
<li><code>linesAboveCursor</code>: <a href="#Customizing%20Source%20Scrolling">Customizing Source Scrolling</a>
17362
<li><code>linesBelowCursor</code>: <a href="#Customizing%20Source%20Scrolling">Customizing Source Scrolling</a>
17363
<li><code>listCoreCommand</code>: <a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>
17364
<li><code>listDirCommand</code>: <a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>
17365
<li><code>listExecCommand</code>: <a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>
17366
<li><code>listSourceCommand</code>: <a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>
17367
<li><code>lookup</code>: <a href="#Images">Images</a>
17368
<li><code>maintenance</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17369
<li><code>maketemp</code>: <a href="#Images">Images</a>
17370
<li><code>maxDisassemble</code>: <a href="#Customizing%20Machine%20Code">Customizing Machine Code</a>
17371
<li><code>maxGlyphs</code>: <a href="#Customizing%20Glyphs">Customizing Glyphs</a>
17372
<li><code>maxUndoDepth</code>: <a href="#Customizing%20Undo">Customizing Undo</a>
17373
<li><code>maxUndoSize</code>: <a href="#Customizing%20Undo">Customizing Undo</a>
17374
<li><code>new_break</code>: <a href="#Images">Images</a>
17375
<li><code>new_display</code>: <a href="#Images">Images</a>
17376
<li><code>new_watch</code>: <a href="#Images">Images</a>
17377
<li><code>openDataWindow</code>: <a href="#Toggling%20Windows">Toggling Windows</a>
17378
<li><code>openDebuggerConsole</code>: <a href="#Toggling%20Windows">Toggling Windows</a>
17379
<li><code>openSelection</code>: <a href="#Opening%20the%20Selection">Opening the Selection</a>
17380
<li><code>openSourceWindow</code>: <a href="#Toggling%20Windows">Toggling Windows</a>
17381
<li><code>PAGER</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>, <a href="#Environment">Environment</a>
17382
<li><code>pannedGraphEditor</code>: <a href="#Scrolling%20Data">Scrolling Data</a>
17383
<li><code>paperSize</code>: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17384
<li><code>perlDisplayShortcuts</code>: <a href="#Display%20Shortcuts">Display Shortcuts</a>
17385
<li><code>perlInitCommands</code>: <a href="#Perl%20Initialization">Perl Initialization</a>
17386
<li><code>perlSettings</code>: <a href="#Perl%20Initialization">Perl Initialization</a>
17387
<li><code>plain_arrow</code>: <a href="#Images">Images</a>
17388
<li><code>plain_cond</code>: <a href="#Images">Images</a>
17389
<li><code>plain_stop</code>: <a href="#Images">Images</a>
17390
<li><code>plain_temp</code>: <a href="#Images">Images</a>
17391
<li><code>plot2dSettings</code>: <a href="#Gnuplot%20Settings">Gnuplot Settings</a>
17392
<li><code>plot3dSettings</code>: <a href="#Gnuplot%20Settings">Gnuplot Settings</a>
17393
<li><code>plotCommand</code>: <a href="#Gnuplot%20Invocation">Gnuplot Invocation</a>
17394
<li><code>plotInitCommands</code>: <a href="#Gnuplot%20Settings">Gnuplot Settings</a>
17395
<li><code>plotTermType</code>: <a href="#Gnuplot%20Invocation">Gnuplot Invocation</a>
17396
<li><code>plotWindowClass</code>: <a href="#Gnuplot%20Invocation">Gnuplot Invocation</a>
17397
<li><code>plotWindowDelay</code>: <a href="#Gnuplot%20Invocation">Gnuplot Invocation</a>
17398
<li><code>popdownHistorySize</code>: <a href="#Text%20Fields">Text Fields</a>
17399
<li><code>positionTimeout</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17400
<li><code>print</code>: <a href="#Images">Images</a>
17401
<li><code>printCommand</code>: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17402
<li><code>properties</code>: <a href="#Images">Images</a>
17403
<li><code>psCommand</code>: <a href="#Customizing%20Attaching%20to%20Processes">Customizing Attaching to Processes</a>
17404
<li><code>pydbDisplayShortcuts</code>: <a href="#Display%20Shortcuts">Display Shortcuts</a>
17405
<li><code>pydbInitCommands</code>: <a href="#PYDB%20Initialization">PYDB Initialization</a>
17406
<li><code>pydbSettings</code>: <a href="#PYDB%20Initialization">PYDB Initialization</a>
17407
<li><code>questionTimeout</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17408
<li><code>rotate</code>: <a href="#Images">Images</a>
17409
<li><code>rshCommand</code>: <a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>
17410
<li><code>runInterruptDelay</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17411
<li><code>saveHistoryOnExit</code>: <a href="#Command%20History">Command History</a>
17412
<li><code>saveOptionsOnExit</code>: <a href="#Saving%20Options">Saving Options</a>
17413
<li><code>selectAllBindings</code>: <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>
17414
<li><code>separateDataWindow</code>: <a href="#Window%20Layout">Window Layout</a>
17415
<li><code>separateExecWindow</code>: <a href="#Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>
17416
<li><code>separateSourceWindow</code>: <a href="#Window%20Layout">Window Layout</a>
17417
<li><code>set</code>: <a href="#Images">Images</a>
17418
<li><code>SHELL</code>: <a href="#Arguments">Arguments</a>
17419
<li><code>show</code>: <a href="#Images">Images</a>
17420
<li><code>showBaseDisplayTitles</code>: <a href="#Display%20Resources">Display Resources</a>
17421
<li><code>showConfiguration</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17422
<li><code>showDependentDisplayTitles</code>: <a href="#Display%20Resources">Display Resources</a>
17423
<li><code>showFonts</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17424
<li><code>showInvocation</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17425
<li><code>showLicense</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17426
<li><code>showManual</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17427
<li><code>showMemberNames</code>: <a href="#Rotating%20Displays">Rotating Displays</a>
17428
<li><code>showNews</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17429
<li><code>showVersion</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17430
<li><code>signal_arrow</code>: <a href="#Images">Images</a>
17431
<li><code>sortPopdownHistory</code>: <a href="#Text%20Fields">Text Fields</a>
17432
<li><code>sourceButtons</code>: <a href="#Customizing%20Buttons">Customizing Buttons</a>
17433
<li><code>sourceEditing</code>: <a href="#In-Place%20Editing">In-Place Editing</a>
17434
<li><code>sourceInitCommands</code>: <a href="#GDB%20Initialization">GDB Initialization</a>
17435
<li><code>splashScreen</code>: <a href="#Splash%20Screen">Splash Screen</a>
17436
<li><code>splashScreenColorKey</code>: <a href="#Splash%20Screen">Splash Screen</a>
17437
<li><code>startupTipCount</code>: <a href="#Tip%20of%20the%20day">Tip of the day</a>
17438
<li><code>startupTips</code>: <a href="#Tip%20of%20the%20day">Tip of the day</a>
17439
<li><code>statusAtBottom</code>: <a href="#Window%20Layout">Window Layout</a>
17440
<li><code>stickyTool</code>: <a href="#Customizing%20Tool%20Position">Customizing Tool Position</a>
17441
<li><code>stopAndContinue</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17442
<li><code>structOrientation</code>: <a href="#Rotating%20Displays">Rotating Displays</a>
17443
<li><code>suppressTheme</code>: <a href="#Display%20Resources">Display Resources</a>
17444
<li><code>suppressWarnings</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>, <a href="#X%20Warnings">X Warnings</a>
17445
<li><code>synchronousDebugger</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17446
<li><code>tabWidth</code>: <a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
17447
<li><code>TERM</code>: <a href="#Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>, <a href="#Environment">Environment</a>
17448
<li><code>TERMCAP</code>: <a href="#Environment">Environment</a>
17449
<li><code>termCommand</code>: <a href="#Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>
17450
<li><code>terminateOnEOF</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17451
<li><code>termType</code>: <a href="#Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>
17452
<li><code>themes</code>: <a href="#Display%20Resources">Display Resources</a>
17453
<li><code>tip</code>: <a href="#Tip%20of%20the%20day">Tip of the day</a>
17454
<li><code>toolbarsAtBottom</code>: <a href="#Window%20Layout">Window Layout</a>
17455
<li><code>toolButtons</code>: <a href="#Customizing%20Buttons">Customizing Buttons</a>
17456
<li><code>toolRightOffset</code>: <a href="#Customizing%20Tool%20Position">Customizing Tool Position</a>
17457
<li><code>toolTopOffset</code>: <a href="#Customizing%20Tool%20Position">Customizing Tool Position</a>
17458
<li><code>trace</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17459
<li><code>typedAliases</code>: <a href="#Shared%20Structures">Shared Structures</a>
17460
<li><code>uncompressCommand</code>: <a href="#Help%20Helpers">Help Helpers</a>
17461
<li><code>undisplay</code>: <a href="#Images">Images</a>
17462
<li><code>uniconifyWhenReady</code>: <a href="#Icons">Icons</a>
17463
<li><code>unwatch</code>: <a href="#Images">Images</a>
17464
<li><code>useSourcePath</code>: <a href="#Customizing%20Source%20Lookup">Customizing Source Lookup</a>
17465
<li><code>useTTYCommand</code>: <a href="#Debugger%20Communication">Debugger Communication</a>
17466
<li><code>valueDocs</code>: <a href="#Value%20Tips">Value Tips</a>
17467
<li><code>valueTips</code>: <a href="#Value%20Tips">Value Tips</a>
17468
<li><code>variableWidthFont</code>: <a href="#Customizing%20Fonts">Customizing Fonts</a>
17469
<li><code>variableWidthFontSize</code>: <a href="#Customizing%20Fonts">Customizing Fonts</a>
17470
<li><code>verifyButtons</code>: <a href="#Customizing%20Buttons">Customizing Buttons</a>
17471
<li><code>vslBaseDefs</code>: <a href="#VSL%20Resources">VSL Resources</a>
17472
<li><code>vslDefs</code>: <a href="#VSL%20Resources">VSL Resources</a>
17473
<li><code>vslLibrary</code>: <a href="#VSL%20Resources">VSL Resources</a>
17474
<li><code>vslPath</code>: <a href="#VSL%20Resources">VSL Resources</a>
17475
<li><code>warnIfLocked</code>: <a href="#Multiple%20Instances">Multiple Instances</a>
17476
<li><code>watch</code>: <a href="#Images">Images</a>
17477
<li><code>WWWBROWSER</code>: <a href="#Help%20Helpers">Help Helpers</a>
17478
<li><code>wwwCommand</code>: <a href="#Help%20Helpers">Help Helpers</a>
17479
<li><code>wwwPage</code>: <a href="#Help%20Helpers">Help Helpers</a>
17480
<li><code>xdbDisplayShortcuts</code>: <a href="#Display%20Shortcuts">Display Shortcuts</a>
17481
<li><code>xdbInitCommands</code>: <a href="#XDB%20Initialization">XDB Initialization</a>
17482
<li><code>xdbSettings</code>: <a href="#XDB%20Initialization">XDB Initialization</a>
17483
<li><code>XEDITOR</code>: <a href="#Customizing%20Editing">Customizing Editing</a>
17484
</ul>
17485
17486
<div class="node">
15113
<li><a href="#index-activeButtonColorKey-475"><code>activeButtonColorKey</code></a>: <a href="#Customizing-the-Tool-Bar">Customizing the Tool Bar</a></li>
15114
<li><a href="#index-align2dArrays-1001"><code>align2dArrays</code></a>: <a href="#Arrays-as-Tables">Arrays as Tables</a></li>
15115
<li><a href="#index-appDefaultsVersion-1366"><code>appDefaultsVersion</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15116
<li><a href="#index-arrayOrientation-941"><code>arrayOrientation</code></a>: <a href="#Rotating-Displays">Rotating Displays</a></li>
15117
<li><a href="#index-autoCloseDataWindow-1050"><code>autoCloseDataWindow</code></a>: <a href="#Display-Resources">Display Resources</a></li>
15118
<li><a href="#index-autoDebugger-162"><code>autoDebugger</code></a>: <a href="#Debugger-Invocation">Debugger Invocation</a></li>
15119
<li><a href="#index-autoRaiseMenu-428"><code>autoRaiseMenu</code></a>: <a href="#Auto_002dRaise-Menus">Auto-Raise Menus</a></li>
15120
<li><a href="#index-autoRaiseMenuDelay-429"><code>autoRaiseMenuDelay</code></a>: <a href="#Auto_002dRaise-Menus">Auto-Raise Menus</a></li>
15121
<li><a href="#index-autoRaiseTool-501"><code>autoRaiseTool</code></a>: <a href="#Customizing-Tool-Position">Customizing Tool Position</a></li>
15122
<li><a href="#index-bash-175"><code>bash</code></a>: <a href="#GNU-Make-Initialization">GNU Make Initialization</a></li>
15123
<li><a href="#index-bash-166"><code>bash</code></a>: <a href="#Bash-Initialization">Bash Initialization</a></li>
15124
<li><a href="#index-bashDisplayShortcuts-1028"><code>bashDisplayShortcuts</code></a>: <a href="#Display-Shortcuts">Display Shortcuts</a></li>
15125
<li><a href="#index-bashInitCommands-165"><code>bashInitCommands</code></a>: <a href="#Bash-Initialization">Bash Initialization</a></li>
15126
<li><a href="#index-blockTTYInput-184"><code>blockTTYInput</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15127
<li><a href="#index-break_005fat-1322"><code>break_at</code></a>: <a href="#Images">Images</a></li>
15128
<li><a href="#index-bufferGDBOutput-185"><code>bufferGDBOutput</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15129
<li><a href="#index-bumpDisplays-1051"><code>bumpDisplays</code></a>: <a href="#Display-Resources">Display Resources</a></li>
15130
<li><a href="#index-buttonCaptionGeometry-477"><code>buttonCaptionGeometry</code></a>: <a href="#Customizing-the-Tool-Bar">Customizing the Tool Bar</a></li>
15131
<li><a href="#index-buttonCaptions-476"><code>buttonCaptions</code></a>: <a href="#Customizing-the-Tool-Bar">Customizing the Tool Bar</a></li>
15132
<li><a href="#index-buttonColorKey-480"><code>buttonColorKey</code></a>: <a href="#Customizing-the-Tool-Bar">Customizing the Tool Bar</a></li>
15133
<li><a href="#index-buttonDocs-549"><code>buttonDocs</code></a>: <a href="#Button-tips">Button tips</a></li>
15134
<li><a href="#index-buttonImageGeometry-479"><code>buttonImageGeometry</code></a>: <a href="#Customizing-the-Tool-Bar">Customizing the Tool Bar</a></li>
15135
<li><a href="#index-buttonImages-478"><code>buttonImages</code></a>: <a href="#Customizing-the-Tool-Bar">Customizing the Tool Bar</a></li>
15136
<li><a href="#index-buttonTips-548"><code>buttonTips</code></a>: <a href="#Button-tips">Button tips</a></li>
15137
<li><a href="#index-cacheGlyphImages-641"><code>cacheGlyphImages</code></a>: <a href="#Customizing-Glyphs">Customizing Glyphs</a></li>
15138
<li><a href="#index-cacheMachineCode-1163"><code>cacheMachineCode</code></a>: <a href="#Customizing-Machine-Code">Customizing Machine Code</a></li>
15139
<li><a href="#index-cacheSourceFiles-662"><code>cacheSourceFiles</code></a>: <a href="#Customizing-Source-Lookup">Customizing Source Lookup</a></li>
15140
<li><a href="#index-checkConfiguration-1367"><code>checkConfiguration</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15141
<li><a href="#index-checkGrabDelay-737"><code>checkGrabDelay</code></a>: <a href="#Customizing-Grab-Checking">Customizing Grab Checking</a></li>
15142
<li><a href="#index-checkGrabs-736"><code>checkGrabs</code></a>: <a href="#Customizing-Grab-Checking">Customizing Grab Checking</a></li>
15143
<li><a href="#index-checkOptions-88"><code>checkOptions</code></a>: <a href="#Multiple-Instances">Multiple Instances</a></li>
15144
<li><a href="#index-CLASSPATH-636"><code>CLASSPATH</code></a>: <a href="#Source-Path">Source Path</a></li>
15145
<li><a href="#index-clear_005fat-1323"><code>clear_at</code></a>: <a href="#Images">Images</a></li>
15146
<li><a href="#index-clusterDisplays-1052"><code>clusterDisplays</code></a>: <a href="#Display-Resources">Display Resources</a></li>
15147
<li><a href="#index-commandToolBar-500"><code>commandToolBar</code></a>: <a href="#Disabling-the-Command-Tool">Disabling the Command Tool</a></li>
15148
<li><a href="#index-commonToolBar-583"><code>commonToolBar</code></a>: <a href="#Window-Layout">Window Layout</a></li>
15149
<li><a href="#index-consoleButtons-1228"><code>consoleButtons</code></a>: <a href="#Customizing-Buttons">Customizing Buttons</a></li>
15150
<li><a href="#index-consoleHasFocus-1213"><code>consoleHasFocus</code></a>: <a href="#Typing-in-the-Source-Window">Typing in the Source Window</a></li>
15151
<li><a href="#index-contInterruptDelay-186"><code>contInterruptDelay</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15152
<li><a href="#index-cutCopyPasteBindings-437"><code>cutCopyPasteBindings</code></a>: <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a></li>
15153
<li><a href="#index-dataButtons-1229"><code>dataButtons</code></a>: <a href="#Customizing-Buttons">Customizing Buttons</a></li>
15154
<li><a href="#index-dataFont-593"><code>dataFont</code></a>: <a href="#Customizing-Fonts">Customizing Fonts</a></li>
15155
<li><a href="#index-dataFontSize-594"><code>dataFontSize</code></a>: <a href="#Customizing-Fonts">Customizing Fonts</a></li>
15156
<li><a href="#index-dbxDisplayShortcuts-1024"><code>dbxDisplayShortcuts</code></a>: <a href="#Display-Shortcuts">Display Shortcuts</a></li>
15157
<li><a href="#index-dbxInitCommands-167"><code>dbxInitCommands</code></a>: <a href="#DBX-Initialization">DBX Initialization</a></li>
15158
<li><a href="#index-dbxSettings-168"><code>dbxSettings</code></a>: <a href="#DBX-Initialization">DBX Initialization</a></li>
15159
<li><a href="#index-ddd-1324"><code>ddd</code></a>: <a href="#Images">Images</a></li>
15160
<li><a href="#index-DDD-755"><code>DDD</code></a>: <a href="#Environment">Environment</a></li>
15161
<li><a href="#index-DDD_005fNO_005fSIGNAL_005fHANDLERS-1365"><code>DDD_NO_SIGNAL_HANDLERS</code></a>: <a href="#Debugging-_003cacronym_003eDDD_003c_002facronym_003e">Debugging <acronym>DDD</acronym></a></li>
15162
<li><a href="#index-DDD_005fSESSION-544"><code>DDD_SESSION</code></a>: <a href="#Resources">Resources</a></li>
15163
<li><a href="#index-DDD_005fSESSIONS-128"><code>DDD_SESSIONS</code></a>: <a href="#Customizing-Sessions">Customizing Sessions</a></li>
15164
<li><a href="#index-DDD_005fSTATE-542"><code>DDD_STATE</code></a>: <a href="#Resources">Resources</a></li>
15165
<li><a href="#index-dddinitVersion-1368"><code>dddinitVersion</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15166
<li><a href="#index-debugCoreDumps-1369"><code>debugCoreDumps</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15167
<li><a href="#index-debugger-163"><code>debugger</code></a>: <a href="#Debugger-Invocation">Debugger Invocation</a></li>
15168
<li><a href="#index-debuggerCommand-164"><code>debuggerCommand</code></a>: <a href="#Debugger-Invocation">Debugger Invocation</a></li>
15169
<li><a href="#index-decorateTool-505"><code>decorateTool</code></a>: <a href="#Customizing-Tool-Decoration">Customizing Tool Decoration</a></li>
15170
<li><a href="#index-defaultFont-587"><code>defaultFont</code></a>: <a href="#Customizing-Fonts">Customizing Fonts</a></li>
15171
<li><a href="#index-defaultFontSize-588"><code>defaultFontSize</code></a>: <a href="#Customizing-Fonts">Customizing Fonts</a></li>
15172
<li><a href="#index-delete-1325"><code>delete</code></a>: <a href="#Images">Images</a></li>
15173
<li><a href="#index-deleteAliasDisplays-1018"><code>deleteAliasDisplays</code></a>: <a href="#Shared-Structures">Shared Structures</a></li>
15174
<li><a href="#index-detectAliases-1019"><code>detectAliases</code></a>: <a href="#Shared-Structures">Shared Structures</a></li>
15175
<li><a href="#index-disable-1326"><code>disable</code></a>: <a href="#Images">Images</a></li>
15176
<li><a href="#index-disassemble-1161"><code>disassemble</code></a>: <a href="#Customizing-Machine-Code">Customizing Machine Code</a></li>
15177
<li><a href="#index-display-1328"><code>display</code></a>: <a href="#Images">Images</a></li>
15178
<li><a href="#index-DISPLAY-136"><code>DISPLAY</code></a>: <a href="#Remote-Host">Remote Host</a></li>
15179
<li><a href="#index-DISPLAY-81"><code>DISPLAY</code></a>: <a href="#X-Options">X Options</a></li>
15180
<li><a href="#index-displayGlyphs-640"><code>displayGlyphs</code></a>: <a href="#Customizing-Glyphs">Customizing Glyphs</a></li>
15181
<li><a href="#index-displayLineNumbers-648"><code>displayLineNumbers</code></a>: <a href="#Customizing-Source-Appearance">Customizing Source Appearance</a></li>
15182
<li><a href="#index-displayPlacement-963"><code>displayPlacement</code></a>: <a href="#Placement">Placement</a></li>
15183
<li><a href="#index-displayTimeout-187"><code>displayTimeout</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15184
<li><a href="#index-dispref-1327"><code>dispref</code></a>: <a href="#Images">Images</a></li>
15185
<li><a href="#index-drag_005farrow-1329"><code>drag_arrow</code></a>: <a href="#Images">Images</a></li>
15186
<li><a href="#index-drag_005fcond-1330"><code>drag_cond</code></a>: <a href="#Images">Images</a></li>
15187
<li><a href="#index-drag_005fstop-1331"><code>drag_stop</code></a>: <a href="#Images">Images</a></li>
15188
<li><a href="#index-drag_005ftemp-1332"><code>drag_temp</code></a>: <a href="#Images">Images</a></li>
15189
<li><a href="#index-dumpCore-1370"><code>dumpCore</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15190
<li><a href="#index-editCommand-1175"><code>editCommand</code></a>: <a href="#Customizing-Editing">Customizing Editing</a></li>
15191
<li><a href="#index-EDITOR-1177"><code>EDITOR</code></a>: <a href="#Customizing-Editing">Customizing Editing</a></li>
15192
<li><a href="#index-enable-1333"><code>enable</code></a>: <a href="#Images">Images</a></li>
15193
<li><a href="#index-expandRepeatedValues-999"><code>expandRepeatedValues</code></a>: <a href="#Repeated-Values">Repeated Values</a></li>
15194
<li><a href="#index-filterFiles-663"><code>filterFiles</code></a>: <a href="#Customizing-File-Filtering">Customizing File Filtering</a></li>
15195
<li><a href="#index-find_005fbackward-1335"><code>find_backward</code></a>: <a href="#Images">Images</a></li>
15196
<li><a href="#index-find_005fforward-1334"><code>find_forward</code></a>: <a href="#Images">Images</a></li>
15197
<li><a href="#index-findCaseSensitive-644"><code>findCaseSensitive</code></a>: <a href="#Customizing-Searching">Customizing Searching</a></li>
15198
<li><a href="#index-findWordsOnly-645"><code>findWordsOnly</code></a>: <a href="#Customizing-Searching">Customizing Searching</a></li>
15199
<li><a href="#index-fixedWidthFont-591"><code>fixedWidthFont</code></a>: <a href="#Customizing-Fonts">Customizing Fonts</a></li>
15200
<li><a href="#index-fixedWidthFontSize-592"><code>fixedWidthFontSize</code></a>: <a href="#Customizing-Fonts">Customizing Fonts</a></li>
15201
<li><a href="#index-flatDialogButtons-482"><code>flatDialogButtons</code></a>: <a href="#Customizing-the-Tool-Bar">Customizing the Tool Bar</a></li>
15202
<li><a href="#index-flatToolbarButtons-481"><code>flatToolbarButtons</code></a>: <a href="#Customizing-the-Tool-Bar">Customizing the Tool Bar</a></li>
15203
<li><a href="#index-fontSelectCommand-595"><code>fontSelectCommand</code></a>: <a href="#Customizing-Fonts">Customizing Fonts</a></li>
15204
<li><a href="#index-gdbDisplayShortcuts-1025"><code>gdbDisplayShortcuts</code></a>: <a href="#Display-Shortcuts">Display Shortcuts</a></li>
15205
<li><a href="#index-gdbInitCommands-169"><code>gdbInitCommands</code></a>: <a href="#GDB-Initialization">GDB Initialization</a></li>
15206
<li><a href="#index-gdbSettings-170"><code>gdbSettings</code></a>: <a href="#GDB-Initialization">GDB Initialization</a></li>
15207
<li><a href="#index-getCoreCommand-132"><code>getCoreCommand</code></a>: <a href="#Customizing-Sessions">Customizing Sessions</a></li>
15208
<li><a href="#index-globalTabCompletion-1200"><code>globalTabCompletion</code></a>: <a href="#Command-Completion">Command Completion</a></li>
15209
<li><a href="#index-glyphUpdateDelay-642"><code>glyphUpdateDelay</code></a>: <a href="#Customizing-Glyphs">Customizing Glyphs</a></li>
15210
<li><a href="#index-grabAction-738"><code>grabAction</code></a>: <a href="#Customizing-Grab-Checking">Customizing Grab Checking</a></li>
15211
<li><a href="#index-grabActionDelay-742"><code>grabActionDelay</code></a>: <a href="#Customizing-Grab-Checking">Customizing Grab Checking</a></li>
15212
<li><a href="#index-grey_005farrow-1336"><code>grey_arrow</code></a>: <a href="#Images">Images</a></li>
15213
<li><a href="#index-grey_005fcond-1337"><code>grey_cond</code></a>: <a href="#Images">Images</a></li>
15214
<li><a href="#index-grey_005fstop-1338"><code>grey_stop</code></a>: <a href="#Images">Images</a></li>
15215
<li><a href="#index-grey_005ftemp-1339"><code>grey_temp</code></a>: <a href="#Images">Images</a></li>
15216
<li><a href="#index-groupIconify-603"><code>groupIconify</code></a>: <a href="#Icons">Icons</a></li>
15217
<li><a href="#index-hide-1340"><code>hide</code></a>: <a href="#Images">Images</a></li>
15218
<li><a href="#index-hideInactiveDisplays-1053"><code>hideInactiveDisplays</code></a>: <a href="#Display-Resources">Display Resources</a></li>
15219
<li><a href="#index-indentCode-1165"><code>indentCode</code></a>: <a href="#Customizing-Machine-Code">Customizing Machine Code</a></li>
15220
<li><a href="#index-indentScript-652"><code>indentScript</code></a>: <a href="#Customizing-Source-Appearance">Customizing Source Appearance</a></li>
15221
<li><a href="#index-indentSource-651"><code>indentSource</code></a>: <a href="#Customizing-Source-Appearance">Customizing Source Appearance</a></li>
15222
<li><a href="#index-initSymbols-182"><code>initSymbols</code></a>: <a href="#Finding-a-Place-to-Start">Finding a Place to Start</a></li>
15223
<li><a href="#index-jdbDisplayShortcuts-1026"><code>jdbDisplayShortcuts</code></a>: <a href="#Display-Shortcuts">Display Shortcuts</a></li>
15224
<li><a href="#index-jdbInitCommands-172"><code>jdbInitCommands</code></a>: <a href="#JDB-Initialization">JDB Initialization</a></li>
15225
<li><a href="#index-jdbSettings-173"><code>jdbSettings</code></a>: <a href="#JDB-Initialization">JDB Initialization</a></li>
15226
<li><a href="#index-labelDelimiter-1232"><code>labelDelimiter</code></a>: <a href="#Customizing-Buttons">Customizing Buttons</a></li>
15227
<li><a href="#index-lessTifVersion-1389"><code>lessTifVersion</code></a>: <a href="#LessTif">LessTif</a></li>
15228
<li><a href="#index-lineBufferedConsole-770"><code>lineBufferedConsole</code></a>: <a href="#Input_002fOutput">Input/Output</a></li>
15229
<li><a href="#index-lineNumberWidth-653"><code>lineNumberWidth</code></a>: <a href="#Customizing-Source-Appearance">Customizing Source Appearance</a></li>
15230
<li><a href="#index-linesAboveCursor-657"><code>linesAboveCursor</code></a>: <a href="#Customizing-Source-Scrolling">Customizing Source Scrolling</a></li>
15231
<li><a href="#index-linesBelowCursor-658"><code>linesBelowCursor</code></a>: <a href="#Customizing-Source-Scrolling">Customizing Source Scrolling</a></li>
15232
<li><a href="#index-listCoreCommand-146"><code>listCoreCommand</code></a>: <a href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a></li>
15233
<li><a href="#index-listDirCommand-148"><code>listDirCommand</code></a>: <a href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a></li>
15234
<li><a href="#index-listExecCommand-150"><code>listExecCommand</code></a>: <a href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a></li>
15235
<li><a href="#index-listSourceCommand-152"><code>listSourceCommand</code></a>: <a href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a></li>
15236
<li><a href="#index-lookup-1341"><code>lookup</code></a>: <a href="#Images">Images</a></li>
15237
<li><a href="#index-maintenance-1371"><code>maintenance</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15238
<li><a href="#index-makeInitCommands-174"><code>makeInitCommands</code></a>: <a href="#GNU-Make-Initialization">GNU Make Initialization</a></li>
15239
<li><a href="#index-maketemp-1342"><code>maketemp</code></a>: <a href="#Images">Images</a></li>
15240
<li><a href="#index-maxDisassemble-1166"><code>maxDisassemble</code></a>: <a href="#Customizing-Machine-Code">Customizing Machine Code</a></li>
15241
<li><a href="#index-maxGlyphs-643"><code>maxGlyphs</code></a>: <a href="#Customizing-Glyphs">Customizing Glyphs</a></li>
15242
<li><a href="#index-maxUndoDepth-572"><code>maxUndoDepth</code></a>: <a href="#Customizing-Undo">Customizing Undo</a></li>
15243
<li><a href="#index-maxUndoSize-571"><code>maxUndoSize</code></a>: <a href="#Customizing-Undo">Customizing Undo</a></li>
15244
<li><a href="#index-new_005fbreak-1343"><code>new_break</code></a>: <a href="#Images">Images</a></li>
15245
<li><a href="#index-new_005fdisplay-1344"><code>new_display</code></a>: <a href="#Images">Images</a></li>
15246
<li><a href="#index-new_005fwatch-1345"><code>new_watch</code></a>: <a href="#Images">Images</a></li>
15247
<li><a href="#index-openDataWindow-597"><code>openDataWindow</code></a>: <a href="#Toggling-Windows">Toggling Windows</a></li>
15248
<li><a href="#index-openDebuggerConsole-598"><code>openDebuggerConsole</code></a>: <a href="#Toggling-Windows">Toggling Windows</a></li>
15249
<li><a href="#index-openSelection-183"><code>openSelection</code></a>: <a href="#Opening-the-Selection">Opening the Selection</a></li>
15250
<li><a href="#index-openSourceWindow-599"><code>openSourceWindow</code></a>: <a href="#Toggling-Windows">Toggling Windows</a></li>
15251
<li><a href="#index-PAGER-1377"><code>PAGER</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15252
<li><a href="#index-PAGER-758"><code>PAGER</code></a>: <a href="#Environment">Environment</a></li>
15253
<li><a href="#index-pannedGraphEditor-1070"><code>pannedGraphEditor</code></a>: <a href="#Scrolling-Data">Scrolling Data</a></li>
15254
<li><a href="#index-paperSize-1099"><code>paperSize</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15255
<li><a href="#index-perlDisplayShortcuts-1027"><code>perlDisplayShortcuts</code></a>: <a href="#Display-Shortcuts">Display Shortcuts</a></li>
15256
<li><a href="#index-perlInitCommands-176"><code>perlInitCommands</code></a>: <a href="#Perl-Initialization">Perl Initialization</a></li>
15257
<li><a href="#index-perlSettings-177"><code>perlSettings</code></a>: <a href="#Perl-Initialization">Perl Initialization</a></li>
15258
<li><a href="#index-plain_005farrow-1346"><code>plain_arrow</code></a>: <a href="#Images">Images</a></li>
15259
<li><a href="#index-plain_005fcond-1347"><code>plain_cond</code></a>: <a href="#Images">Images</a></li>
15260
<li><a href="#index-plain_005fstop-1348"><code>plain_stop</code></a>: <a href="#Images">Images</a></li>
15261
<li><a href="#index-plain_005ftemp-1349"><code>plain_temp</code></a>: <a href="#Images">Images</a></li>
15262
<li><a href="#index-plot2dSettings-1146"><code>plot2dSettings</code></a>: <a href="#Gnuplot-Settings">Gnuplot Settings</a></li>
15263
<li><a href="#index-plot3dSettings-1147"><code>plot3dSettings</code></a>: <a href="#Gnuplot-Settings">Gnuplot Settings</a></li>
15264
<li><a href="#index-plotCommand-1139"><code>plotCommand</code></a>: <a href="#Gnuplot-Invocation">Gnuplot Invocation</a></li>
15265
<li><a href="#index-plotInitCommands-1145"><code>plotInitCommands</code></a>: <a href="#Gnuplot-Settings">Gnuplot Settings</a></li>
15266
<li><a href="#index-plotTermType-1141"><code>plotTermType</code></a>: <a href="#Gnuplot-Invocation">Gnuplot Invocation</a></li>
15267
<li><a href="#index-plotWindowClass-1143"><code>plotWindowClass</code></a>: <a href="#Gnuplot-Invocation">Gnuplot Invocation</a></li>
15268
<li><a href="#index-plotWindowDelay-1144"><code>plotWindowDelay</code></a>: <a href="#Gnuplot-Invocation">Gnuplot Invocation</a></li>
15269
<li><a href="#index-popdownHistorySize-600"><code>popdownHistorySize</code></a>: <a href="#Text-Fields">Text Fields</a></li>
15270
<li><a href="#index-positionTimeout-188"><code>positionTimeout</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15271
<li><a href="#index-print-1350"><code>print</code></a>: <a href="#Images">Images</a></li>
15272
<li><a href="#index-printCommand-1098"><code>printCommand</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15273
<li><a href="#index-properties-1351"><code>properties</code></a>: <a href="#Images">Images</a></li>
15274
<li><a href="#index-psCommand-788"><code>psCommand</code></a>: <a href="#Customizing-Attaching-to-Processes">Customizing Attaching to Processes</a></li>
15275
<li><a href="#index-pydbDisplayShortcuts-1029"><code>pydbDisplayShortcuts</code></a>: <a href="#Display-Shortcuts">Display Shortcuts</a></li>
15276
<li><a href="#index-pydbInitCommands-178"><code>pydbInitCommands</code></a>: <a href="#PYDB-Initialization">PYDB Initialization</a></li>
15277
<li><a href="#index-pydbSettings-179"><code>pydbSettings</code></a>: <a href="#PYDB-Initialization">PYDB Initialization</a></li>
15278
<li><a href="#index-questionTimeout-189"><code>questionTimeout</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15279
<li><a href="#index-rotate-1352"><code>rotate</code></a>: <a href="#Images">Images</a></li>
15280
<li><a href="#index-rshCommand-141"><code>rshCommand</code></a>: <a href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a></li>
15281
<li><a href="#index-runInterruptDelay-190"><code>runInterruptDelay</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15282
<li><a href="#index-saveHistoryOnExit-1211"><code>saveHistoryOnExit</code></a>: <a href="#Command-History">Command History</a></li>
15283
<li><a href="#index-saveOptionsOnExit-545"><code>saveOptionsOnExit</code></a>: <a href="#Saving-Options">Saving Options</a></li>
15284
<li><a href="#index-selectAllBindings-438"><code>selectAllBindings</code></a>: <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a></li>
15285
<li><a href="#index-separateDataWindow-578"><code>separateDataWindow</code></a>: <a href="#Window-Layout">Window Layout</a></li>
15286
<li><a href="#index-separateExecWindow-780"><code>separateExecWindow</code></a>: <a href="#Customizing-the-Execution-Window">Customizing the Execution Window</a></li>
15287
<li><a href="#index-separateSourceWindow-579"><code>separateSourceWindow</code></a>: <a href="#Window-Layout">Window Layout</a></li>
15288
<li><a href="#index-set-1353"><code>set</code></a>: <a href="#Images">Images</a></li>
15289
<li><a href="#index-SHELL-751"><code>SHELL</code></a>: <a href="#Arguments">Arguments</a></li>
15290
<li><a href="#index-show-1354"><code>show</code></a>: <a href="#Images">Images</a></li>
15291
<li><a href="#index-showBaseDisplayTitles-1054"><code>showBaseDisplayTitles</code></a>: <a href="#Display-Resources">Display Resources</a></li>
15292
<li><a href="#index-showConfiguration-1372"><code>showConfiguration</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15293
<li><a href="#index-showDependentDisplayTitles-1055"><code>showDependentDisplayTitles</code></a>: <a href="#Display-Resources">Display Resources</a></li>
15294
<li><a href="#index-showFonts-1373"><code>showFonts</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15295
<li><a href="#index-showInvocation-1374"><code>showInvocation</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15296
<li><a href="#index-showLicense-1375"><code>showLicense</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15297
<li><a href="#index-showManual-1376"><code>showManual</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15298
<li><a href="#index-showMemberNames-942"><code>showMemberNames</code></a>: <a href="#Rotating-Displays">Rotating Displays</a></li>
15299
<li><a href="#index-showNews-1380"><code>showNews</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15300
<li><a href="#index-showVersion-1381"><code>showVersion</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15301
<li><a href="#index-signal_005farrow-1355"><code>signal_arrow</code></a>: <a href="#Images">Images</a></li>
15302
<li><a href="#index-sortPopdownHistory-601"><code>sortPopdownHistory</code></a>: <a href="#Text-Fields">Text Fields</a></li>
15303
<li><a href="#index-sourceButtons-1230"><code>sourceButtons</code></a>: <a href="#Customizing-Buttons">Customizing Buttons</a></li>
15304
<li><a href="#index-sourceEditing-1185"><code>sourceEditing</code></a>: <a href="#In_002dPlace-Editing">In-Place Editing</a></li>
15305
<li><a href="#index-sourceInitCommands-171"><code>sourceInitCommands</code></a>: <a href="#GDB-Initialization">GDB Initialization</a></li>
15306
<li><a href="#index-splashScreen-575"><code>splashScreen</code></a>: <a href="#Splash-Screen">Splash Screen</a></li>
15307
<li><a href="#index-splashScreenColorKey-576"><code>splashScreenColorKey</code></a>: <a href="#Splash-Screen">Splash Screen</a></li>
15308
<li><a href="#index-startupTipCount-552"><code>startupTipCount</code></a>: <a href="#Tip-of-the-day">Tip of the day</a></li>
15309
<li><a href="#index-startupTips-551"><code>startupTips</code></a>: <a href="#Tip-of-the-day">Tip of the day</a></li>
15310
<li><a href="#index-statusAtBottom-585"><code>statusAtBottom</code></a>: <a href="#Window-Layout">Window Layout</a></li>
15311
<li><a href="#index-stickyTool-502"><code>stickyTool</code></a>: <a href="#Customizing-Tool-Position">Customizing Tool Position</a></li>
15312
<li><a href="#index-stopAndContinue-191"><code>stopAndContinue</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15313
<li><a href="#index-structOrientation-943"><code>structOrientation</code></a>: <a href="#Rotating-Displays">Rotating Displays</a></li>
15314
<li><a href="#index-suppressTheme-1056"><code>suppressTheme</code></a>: <a href="#Display-Resources">Display Resources</a></li>
15315
<li><a href="#index-suppressWarnings-1382"><code>suppressWarnings</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15316
<li><a href="#index-suppressWarnings-93"><code>suppressWarnings</code></a>: <a href="#X-Warnings">X Warnings</a></li>
15317
<li><a href="#index-synchronousDebugger-194"><code>synchronousDebugger</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15318
<li><a href="#index-tabWidth-656"><code>tabWidth</code></a>: <a href="#Customizing-Source-Appearance">Customizing Source Appearance</a></li>
15319
<li><a href="#index-TERM-779"><code>TERM</code></a>: <a href="#Customizing-the-Execution-Window">Customizing the Execution Window</a></li>
15320
<li><a href="#index-TERM-756"><code>TERM</code></a>: <a href="#Environment">Environment</a></li>
15321
<li><a href="#index-TERMCAP-757"><code>TERMCAP</code></a>: <a href="#Environment">Environment</a></li>
15322
<li><a href="#index-termCommand-776"><code>termCommand</code></a>: <a href="#Customizing-the-Execution-Window">Customizing the Execution Window</a></li>
15323
<li><a href="#index-terminateOnEOF-195"><code>terminateOnEOF</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15324
<li><a href="#index-termType-778"><code>termType</code></a>: <a href="#Customizing-the-Execution-Window">Customizing the Execution Window</a></li>
15325
<li><a href="#index-themes-1058"><code>themes</code></a>: <a href="#Display-Resources">Display Resources</a></li>
15326
<li><a href="#index-tip-553"><code>tip</code></a>: <a href="#Tip-of-the-day">Tip of the day</a></li>
15327
<li><a href="#index-toolbarsAtBottom-582"><code>toolbarsAtBottom</code></a>: <a href="#Window-Layout">Window Layout</a></li>
15328
<li><a href="#index-toolButtons-1231"><code>toolButtons</code></a>: <a href="#Customizing-Buttons">Customizing Buttons</a></li>
15329
<li><a href="#index-toolRightOffset-503"><code>toolRightOffset</code></a>: <a href="#Customizing-Tool-Position">Customizing Tool Position</a></li>
15330
<li><a href="#index-toolTopOffset-504"><code>toolTopOffset</code></a>: <a href="#Customizing-Tool-Position">Customizing Tool Position</a></li>
15331
<li><a href="#index-trace-1383"><code>trace</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15332
<li><a href="#index-typedAliases-1020"><code>typedAliases</code></a>: <a href="#Shared-Structures">Shared Structures</a></li>
15333
<li><a href="#index-uncompressCommand-555"><code>uncompressCommand</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15334
<li><a href="#index-undisplay-1356"><code>undisplay</code></a>: <a href="#Images">Images</a></li>
15335
<li><a href="#index-uniconifyWhenReady-604"><code>uniconifyWhenReady</code></a>: <a href="#Icons">Icons</a></li>
15336
<li><a href="#index-unwatch-1357"><code>unwatch</code></a>: <a href="#Images">Images</a></li>
15337
<li><a href="#index-useSourcePath-660"><code>useSourcePath</code></a>: <a href="#Customizing-Source-Lookup">Customizing Source Lookup</a></li>
15338
<li><a href="#index-useTTYCommand-196"><code>useTTYCommand</code></a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15339
<li><a href="#index-valueDocs-879"><code>valueDocs</code></a>: <a href="#Value-Tips">Value Tips</a></li>
15340
<li><a href="#index-valueTips-878"><code>valueTips</code></a>: <a href="#Value-Tips">Value Tips</a></li>
15341
<li><a href="#index-variableWidthFont-589"><code>variableWidthFont</code></a>: <a href="#Customizing-Fonts">Customizing Fonts</a></li>
15342
<li><a href="#index-variableWidthFontSize-590"><code>variableWidthFontSize</code></a>: <a href="#Customizing-Fonts">Customizing Fonts</a></li>
15343
<li><a href="#index-verifyButtons-1233"><code>verifyButtons</code></a>: <a href="#Customizing-Buttons">Customizing Buttons</a></li>
15344
<li><a href="#index-vslBaseDefs-1059"><code>vslBaseDefs</code></a>: <a href="#VSL-Resources">VSL Resources</a></li>
15345
<li><a href="#index-vslDefs-1060"><code>vslDefs</code></a>: <a href="#VSL-Resources">VSL Resources</a></li>
15346
<li><a href="#index-vslLibrary-1061"><code>vslLibrary</code></a>: <a href="#VSL-Resources">VSL Resources</a></li>
15347
<li><a href="#index-vslPath-1062"><code>vslPath</code></a>: <a href="#VSL-Resources">VSL Resources</a></li>
15348
<li><a href="#index-warnIfLocked-90"><code>warnIfLocked</code></a>: <a href="#Multiple-Instances">Multiple Instances</a></li>
15349
<li><a href="#index-watch-1358"><code>watch</code></a>: <a href="#Images">Images</a></li>
15350
<li><a href="#index-WWWBROWSER-561"><code>WWWBROWSER</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15351
<li><a href="#index-wwwCommand-560"><code>wwwCommand</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15352
<li><a href="#index-wwwPage-569"><code>wwwPage</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15353
<li><a href="#index-xdbDisplayShortcuts-1030"><code>xdbDisplayShortcuts</code></a>: <a href="#Display-Shortcuts">Display Shortcuts</a></li>
15354
<li><a href="#index-xdbInitCommands-180"><code>xdbInitCommands</code></a>: <a href="#XDB-Initialization">XDB Initialization</a></li>
15355
<li><a href="#index-xdbSettings-181"><code>xdbSettings</code></a>: <a href="#XDB-Initialization">XDB Initialization</a></li>
15356
<li><a href="#index-XEDITOR-1176"><code>XEDITOR</code></a>: <a href="#Customizing-Editing">Customizing Editing</a></li>
15357
</ul><div class="node">
17487
15358
<p><hr>
17488
<small class=header>
17489
Node:<a name="File%20Index">File Index</a>,
17490
Next:<a rel="next" accesskey="n" href="#Concept%20Index">Concept Index</a>,
17491
Previous:<a rel="previous" accesskey="p" href="#Resource%20Index">Resource Index</a>,
17492
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
15359
<a name="File-Index"></a>
15360
Next: <a rel="next" accesskey="n" href="#Concept-Index">Concept Index</a>,
15361
Previous: <a rel="previous" accesskey="p" href="#Resource-Index">Resource Index</a>,
15362
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
17493
15363
</small>
17494
15364
17495
<br>
15365
17496
15366
</div>
17497
15367
17498
15368
<h2 class="unnumbered">File Index</h2>
17499
15369
15370
15371
17500
15372
<ul class="index-fl" compact>
17501
<li><code>.emacs</code>: <a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>
17502
<li><code>.gdbinit</code>: <a href="#Debugging%20%3csmall%3eDDD%3c%2fsmall%3e">Debugging <small>DDD</small></a>, <a href="#Remote%20Program">Remote Program</a>, <a href="#GDB%20Options">GDB Options</a>
17503
<li><code>ChangeLog</code>: <a href="#Contributors">Contributors</a>
17504
<li><code>dbx</code>: <a href="#Options">Options</a>
17505
<li><code>Ddd</code>: <a href="#Application%20Defaults">Application Defaults</a>, <a href="#More%20Customizations">More Customizations</a>, <a href="#Resources">Resources</a>
17506
<li><code>ddd-3.3.11-html-manual.tar.gz</code>: <a href="#About%20this%20Manual">About this Manual</a>
17507
<li><code>ddd-3.3.11-pics.tar.gz</code>: <a href="#About%20this%20Manual">About this Manual</a>
17508
<li><code>ddd-3.3.11.tar.gz</code>: <a href="#About%20this%20Manual">About this Manual</a>
17509
<li><code>ddd-</code><var>version</var><code>-html-manual.tar.gz</code>: <a href="#Getting%20%3csmall%3eDDD%3c%2fsmall%3e">Getting <small>DDD</small></a>
17510
<li><code>ddd-</code><var>version</var><code>-pics.tar.gz</code>: <a href="#Getting%20%3csmall%3eDDD%3c%2fsmall%3e">Getting <small>DDD</small></a>
17511
<li><code>ddd-</code><var>version</var><code>.tar.gz</code>: <a href="#Getting%20%3csmall%3eDDD%3c%2fsmall%3e">Getting <small>DDD</small></a>
17512
<li><code>emacs</code>: <a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>, <a href="#Customizing%20Editing">Customizing Editing</a>, <a href="#Help%20Helpers">Help Helpers</a>
17513
<li><code>emacsclient</code>: <a href="#Customizing%20Editing">Customizing Editing</a>
17514
<li><code>emacsserver</code>: <a href="#Customizing%20Editing">Customizing Editing</a>
17515
<li><code>fig2dev</code>: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17516
<li><code>file</code>: <a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>
17517
<li><code>gdb</code>: <a href="#Options">Options</a>
17518
<li><code>gdbserver</code>: <a href="#Remote%20Program">Remote Program</a>
17519
<li><code>gnuclient</code>: <a href="#Customizing%20Editing">Customizing Editing</a>
17520
<li><code>gnudoit</code>: <a href="#Help%20Helpers">Help Helpers</a>
17521
<li><code>gnuplot</code>: <a href="#Plot%20Appearance">Plot Appearance</a>
17522
<li><code>gnuserv</code>: <a href="#Customizing%20Editing">Customizing Editing</a>
17523
<li><code>init</code>: <a href="#Resources">Resources</a>
17524
<li><code>java.prof</code>: <a href="#JDB%20Options">JDB Options</a>
17525
<li><code>jdb</code>: <a href="#Options">Options</a>
17526
<li><code>ladebug</code>: <a href="#Options">Options</a>
17527
<li><code>less</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17528
<li><code>log</code>: <a href="#Logging">Logging</a>, <a href="#Entering%20Plotting%20Commands">Entering Plotting Commands</a>, <a href="#Options">Options</a>
17529
<li><code>lynx</code>: <a href="#Help%20Helpers">Help Helpers</a>
17530
<li><code>make</code>: <a href="#Recompiling">Recompiling</a>
17531
<li><code>more</code>: <a href="#Customizing%20Diagnostics">Customizing Diagnostics</a>
17532
<li><code>mosaic</code>: <a href="#Help%20Helpers">Help Helpers</a>
17533
<li><code>mozilla</code>: <a href="#Help%20Helpers">Help Helpers</a>
17534
<li><code>netscape</code>: <a href="#Help%20Helpers">Help Helpers</a>
17535
<li><code>on</code>: <a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>
17536
<li><code>perl</code>: <a href="#Options">Options</a>
17537
<li><code>ps</code>: <a href="#Customizing%20Attaching%20to%20Processes">Customizing Attaching to Processes</a>
17538
<li><code>pydb</code>: <a href="#Options">Options</a>
17539
<li><code>remsh</code>: <a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>
17540
<li><code>rsh</code>: <a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>
17541
<li><code>sample</code>: <a href="#Sample%20Session">Sample Session</a>
17542
<li><code>sample.c</code>: <a href="#Sample%20Program">Sample Program</a>, <a href="#Sample%20Session">Sample Session</a>
17543
<li><code>sessions</code>: <a href="#Customizing%20Sessions">Customizing Sessions</a>
17544
<li><code>ssh</code>: <a href="#Customizing%20Remote%20Debugging">Customizing Remote Debugging</a>
17545
<li><code>stty</code>: <a href="#Input%2fOutput">Input/Output</a>
17546
<li><code>suppress.vsl</code>: <a href="#Display%20Resources">Display Resources</a>
17547
<li><code>TODO</code>: <a href="#Contributors">Contributors</a>
17548
<li><code>transfig</code>: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17549
<li><code>vi</code>: <a href="#Customizing%20Editing">Customizing Editing</a>
17550
<li><code>wdb</code>: <a href="#Options">Options</a>
17551
<li><code>xdb</code>: <a href="#Options">Options</a>
17552
<li><code>xemacs</code>: <a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>, <a href="#Customizing%20Editing">Customizing Editing</a>, <a href="#Help%20Helpers">Help Helpers</a>
17553
<li><code>xfig</code>: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17554
<li><code>xfontsel</code>: <a href="#Customizing%20Fonts">Customizing Fonts</a>
17555
<li><code>xmgr</code>: <a href="#Exporting%20Plot%20Data">Exporting Plot Data</a>
17556
<li><code>xsm</code>: <a href="#Resuming%20Sessions">Resuming Sessions</a>
17557
<li><code>xterm</code>: <a href="#Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>
17558
<li><code>xxgdb</code>: <a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>
17559
<li><code>~</code>: <a href="#Resources">Resources</a>, <a href="#Options">Options</a>
17560
</ul>
17561
17562
<div class="node">
15373
<li><a href="#index-g_t_002eemacs-1221"><code>.emacs</code></a>: <a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">Integrating <acronym>DDD</acronym></a></li>
15374
<li><a href="#index-g_t_002egdbinit-1363"><code>.gdbinit</code></a>: <a href="#Debugging-_003cacronym_003eDDD_003c_002facronym_003e">Debugging <acronym>DDD</acronym></a></li>
15375
<li><a href="#index-g_t_002egdbinit-159"><code>.gdbinit</code></a>: <a href="#Remote-Program">Remote Program</a></li>
15376
<li><a href="#index-g_t_002egdbinit-84"><code>.gdbinit</code></a>: <a href="#GDB-Options">GDB Options</a></li>
15377
<li><a href="#index-ChangeLog-38"><code>ChangeLog</code></a>: <a href="#Contributors">Contributors</a></li>
15378
<li><a href="#index-dbx-63"><code>dbx</code></a>: <a href="#Options">Options</a></li>
15379
<li><a href="#index-Ddd-1254"><code>Ddd</code></a>: <a href="#Application-Defaults">Application Defaults</a></li>
15380
<li><a href="#index-Ddd-605"><code>Ddd</code></a>: <a href="#More-Customizations">More Customizations</a></li>
15381
<li><a href="#index-Ddd-543"><code>Ddd</code></a>: <a href="#Resources">Resources</a></li>
15382
<li><a href="#index-ddd_002d_0040value_007bVERSION_007d_002dhtml_002dmanual_002etar_002egz-27"><code>ddd-3.3.12-html-manual.tar.gz</code></a>: <a href="#About-this-Manual">About this Manual</a></li>
15383
<li><a href="#index-ddd_002d_0040value_007bVERSION_007d_002dpics_002etar_002egz-29"><code>ddd-3.3.12-pics.tar.gz</code></a>: <a href="#About-this-Manual">About this Manual</a></li>
15384
<li><a href="#index-ddd_002d_0040value_007bVERSION_007d_002etar_002egz-23"><code>ddd-3.3.12.tar.gz</code></a>: <a href="#About-this-Manual">About this Manual</a></li>
15385
<li><a href="#index-ddd_002d_0040var_007bversion_007d_002dhtml_002dmanual_002etar_002egz-33"><code>ddd-</code><var>version</var><code>-html-manual.tar.gz</code></a>: <a href="#Getting-_003cacronym_003eDDD_003c_002facronym_003e">Getting <acronym>DDD</acronym></a></li>
15386
<li><a href="#index-ddd_002d_0040var_007bversion_007d_002dpics_002etar_002egz-34"><code>ddd-</code><var>version</var><code>-pics.tar.gz</code></a>: <a href="#Getting-_003cacronym_003eDDD_003c_002facronym_003e">Getting <acronym>DDD</acronym></a></li>
15387
<li><a href="#index-ddd_002d_0040var_007bversion_007d_002etar_002egz-32"><code>ddd-</code><var>version</var><code>.tar.gz</code></a>: <a href="#Getting-_003cacronym_003eDDD_003c_002facronym_003e">Getting <acronym>DDD</acronym></a></li>
15388
<li><a href="#index-emacs-1218"><code>emacs</code></a>: <a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">Integrating <acronym>DDD</acronym></a></li>
15389
<li><a href="#index-emacs-1184"><code>emacs</code></a>: <a href="#Customizing-Editing">Customizing Editing</a></li>
15390
<li><a href="#index-emacs-564"><code>emacs</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15391
<li><a href="#index-emacsclient-1182"><code>emacsclient</code></a>: <a href="#Customizing-Editing">Customizing Editing</a></li>
15392
<li><a href="#index-emacsserver-1183"><code>emacsserver</code></a>: <a href="#Customizing-Editing">Customizing Editing</a></li>
15393
<li><a href="#index-fig2dev-1093"><code>fig2dev</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15394
<li><a href="#index-file-147"><code>file</code></a>: <a href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a></li>
15395
<li><a href="#index-firefox-566"><code>firefox</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15396
<li><a href="#index-gdb-64"><code>gdb</code></a>: <a href="#Options">Options</a></li>
15397
<li><a href="#index-gdbserver-156"><code>gdbserver</code></a>: <a href="#Remote-Program">Remote Program</a></li>
15398
<li><a href="#index-gnuclient-1179"><code>gnuclient</code></a>: <a href="#Customizing-Editing">Customizing Editing</a></li>
15399
<li><a href="#index-gnudoit-567"><code>gnudoit</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15400
<li><a href="#index-gnuplot-1105"><code>gnuplot</code></a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
15401
<li><a href="#index-gnuserv-1180"><code>gnuserv</code></a>: <a href="#Customizing-Editing">Customizing Editing</a></li>
15402
<li><a href="#index-init-540"><code>init</code></a>: <a href="#Resources">Resources</a></li>
15403
<li><a href="#index-java_002eprof-87"><code>java.prof</code></a>: <a href="#JDB-Options">JDB Options</a></li>
15404
<li><a href="#index-jdb-66"><code>jdb</code></a>: <a href="#Options">Options</a></li>
15405
<li><a href="#index-ladebug-65"><code>ladebug</code></a>: <a href="#Options">Options</a></li>
15406
<li><a href="#index-less-1378"><code>less</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15407
<li><a href="#index-log-1360"><code>log</code></a>: <a href="#Logging">Logging</a></li>
15408
<li><a href="#index-log-1132"><code>log</code></a>: <a href="#Entering-Plotting-Commands">Entering Plotting Commands</a></li>
15409
<li><a href="#index-log-75"><code>log</code></a>: <a href="#Options">Options</a></li>
15410
<li><a href="#index-lynx-568"><code>lynx</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15411
<li><a href="#index-make-1188"><code>make</code></a>: <a href="#Recompiling">Recompiling</a></li>
15412
<li><a href="#index-mdb-67"><code>mdb</code></a>: <a href="#Options">Options</a></li>
15413
<li><a href="#index-more-1379"><code>more</code></a>: <a href="#Customizing-Diagnostics">Customizing Diagnostics</a></li>
15414
<li><a href="#index-mozilla-563"><code>mozilla</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15415
<li><a href="#index-netscape-562"><code>netscape</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15416
<li><a href="#index-on-145"><code>on</code></a>: <a href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a></li>
15417
<li><a href="#index-perl-68"><code>perl</code></a>: <a href="#Options">Options</a></li>
15418
<li><a href="#index-ps-789"><code>ps</code></a>: <a href="#Customizing-Attaching-to-Processes">Customizing Attaching to Processes</a></li>
15419
<li><a href="#index-pydb-69"><code>pydb</code></a>: <a href="#Options">Options</a></li>
15420
<li><a href="#index-remsh-142"><code>remsh</code></a>: <a href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a></li>
15421
<li><a href="#index-rsh-143"><code>rsh</code></a>: <a href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a></li>
15422
<li><a href="#index-sample-47"><code>sample</code></a>: <a href="#Sample-Session">Sample Session</a></li>
15423
<li><a href="#index-sample_002ec-49"><code>sample.c</code></a>: <a href="#Sample-Program">Sample Program</a></li>
15424
<li><a href="#index-sample_002ec-48"><code>sample.c</code></a>: <a href="#Sample-Session">Sample Session</a></li>
15425
<li><a href="#index-sessions-129"><code>sessions</code></a>: <a href="#Customizing-Sessions">Customizing Sessions</a></li>
15426
<li><a href="#index-ssh-144"><code>ssh</code></a>: <a href="#Customizing-Remote-Debugging">Customizing Remote Debugging</a></li>
15427
<li><a href="#index-stty-769"><code>stty</code></a>: <a href="#Input_002fOutput">Input/Output</a></li>
15428
<li><a href="#index-suppress_002evsl-1057"><code>suppress.vsl</code></a>: <a href="#Display-Resources">Display Resources</a></li>
15429
<li><a href="#index-TODO-39"><code>TODO</code></a>: <a href="#Contributors">Contributors</a></li>
15430
<li><a href="#index-transfig-1092"><code>transfig</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15431
<li><a href="#index-vi-1178"><code>vi</code></a>: <a href="#Customizing-Editing">Customizing Editing</a></li>
15432
<li><a href="#index-wdb-70"><code>wdb</code></a>: <a href="#Options">Options</a></li>
15433
<li><a href="#index-xdb-71"><code>xdb</code></a>: <a href="#Options">Options</a></li>
15434
<li><a href="#index-xemacs-1220"><code>xemacs</code></a>: <a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">Integrating <acronym>DDD</acronym></a></li>
15435
<li><a href="#index-xemacs-1181"><code>xemacs</code></a>: <a href="#Customizing-Editing">Customizing Editing</a></li>
15436
<li><a href="#index-xemacs-565"><code>xemacs</code></a>: <a href="#Help-Helpers">Help Helpers</a></li>
15437
<li><a href="#index-xfig-1091"><code>xfig</code></a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15438
<li><a href="#index-xfontsel-596"><code>xfontsel</code></a>: <a href="#Customizing-Fonts">Customizing Fonts</a></li>
15439
<li><a href="#index-xmgr-1135"><code>xmgr</code></a>: <a href="#Exporting-Plot-Data">Exporting Plot Data</a></li>
15440
<li><a href="#index-xsm-124"><code>xsm</code></a>: <a href="#Resuming-Sessions">Resuming Sessions</a></li>
15441
<li><a href="#index-xterm-777"><code>xterm</code></a>: <a href="#Customizing-the-Execution-Window">Customizing the Execution Window</a></li>
15442
<li><a href="#index-xxgdb-1223"><code>xxgdb</code></a>: <a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">Integrating <acronym>DDD</acronym></a></li>
15443
<li><a href="#index-g_t_007e-541"><code>~</code></a>: <a href="#Resources">Resources</a></li>
15444
<li><a href="#index-g_t_007e-78"><code>~</code></a>: <a href="#Options">Options</a></li>
15445
</ul><div class="node">
17563
15446
<p><hr>
17564
<small class=header>
17565
Node:<a name="Concept%20Index">Concept Index</a>,
17566
Previous:<a rel="previous" accesskey="p" href="#File%20Index">File Index</a>,
17567
Up:<a rel="up" accesskey="u" href="#Top">Top</a>
15447
<a name="Concept-Index"></a>
15448
Previous: <a rel="previous" accesskey="p" href="#File-Index">File Index</a>,
15449
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
17568
15450
</small>
17569
15451
17570
<br>
15452
17571
15453
</div>
17572
15454
17573
15455
<h2 class="unnumbered">Concept Index</h2>
17574
15456
15457
15458
17575
15459
<ul class="index-cp" compact>
17576
<li>Aborting execution: <a href="#Program%20Menu">Program Menu</a>, <a href="#Quitting">Quitting</a>
17577
<li>Ada: <a href="#Summary">Summary</a>
17578
<li>Aliases, detecting: <a href="#Shared%20Structures">Shared Structures</a>
17579
<li>Animating plots: <a href="#Animating%20Plots">Animating Plots</a>
17580
<li>Arguments, displaying: <a href="#Displaying%20Local%20Variables">Displaying Local Variables</a>
17581
<li>Arguments, of the debugged program: <a href="#Arguments">Arguments</a>
17582
<li>Arguments, program: <a href="#Starting%20Program%20Execution">Starting Program Execution</a>
17583
<li>Array slices: <a href="#Array%20Slices">Array Slices</a>
17584
<li>Array, artificial: <a href="#Array%20Slices">Array Slices</a>
17585
<li>Array, plotting: <a href="#Plotting%20Arrays">Plotting Arrays</a>
17586
<li>Artificial arrays: <a href="#Array%20Slices">Array Slices</a>
17587
<li>Assertions and breakpoints: <a href="#Breakpoint%20Conditions">Breakpoint Conditions</a>
17588
<li>Assertions and watchpoints: <a href="#Watchpoints">Watchpoints</a>
17589
<li>Assignment: <a href="#Assignment">Assignment</a>
17590
<li>Assistance: <a href="#Help%20and%20Assistance">Help and Assistance</a>
17591
<li>Auto-command: <a href="#Commands%20with%20Other%20Debuggers">Commands with Other Debuggers</a>
17592
<li>Automatic Layout: <a href="#Automatic%20Layout">Automatic Layout</a>
17593
<li>Balloon help: <a href="#Getting%20Help">Getting Help</a>
17594
<li>Bash: <a href="#Summary">Summary</a>
17595
<li>Bash, invoking <small>DDD</small> with: <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>
17596
<li>Box library: <a href="#History">History</a>
17597
<li>Breakpoint: <a href="#Stopping">Stopping</a>
17598
<li>Breakpoint commands: <a href="#Breakpoint%20Commands">Breakpoint Commands</a>
17599
<li>Breakpoint commands, vs. conditions: <a href="#Breakpoint%20Conditions">Breakpoint Conditions</a>
17600
<li>Breakpoint conditions: <a href="#Breakpoint%20Conditions">Breakpoint Conditions</a>
17601
<li>Breakpoint ignore counts: <a href="#Breakpoint%20Ignore%20Counts">Breakpoint Ignore Counts</a>
17602
<li>Breakpoint properties: <a href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>
17603
<li>Breakpoint, copying: <a href="#Moving%20and%20Copying%20Breakpoints">Moving and Copying Breakpoints</a>
17604
<li>Breakpoint, deleting: <a href="#Deleting%20Breakpoints">Deleting Breakpoints</a>
17605
<li>Breakpoint, disabling: <a href="#Disabling%20Breakpoints">Disabling Breakpoints</a>
17606
<li>Breakpoint, dragging: <a href="#Moving%20and%20Copying%20Breakpoints">Moving and Copying Breakpoints</a>
17607
<li>Breakpoint, editing: <a href="#Editing%20Breakpoint%20Properties">Editing Breakpoint Properties</a>
17608
<li>Breakpoint, enabling: <a href="#Disabling%20Breakpoints">Disabling Breakpoints</a>
17609
<li>Breakpoint, hardware-assisted: <a href="#Hardware-Assisted%20Breakpoints">Hardware-Assisted Breakpoints</a>
17610
<li>Breakpoint, looking up: <a href="#Looking%20up%20Breakpoints">Looking up Breakpoints</a>
17611
<li>Breakpoint, moving: <a href="#Moving%20and%20Copying%20Breakpoints">Moving and Copying Breakpoints</a>
17612
<li>Breakpoint, setting: <a href="#Setting%20Breakpoints">Setting Breakpoints</a>
17613
<li>Breakpoint, temporary: <a href="#Temporary%20Breakpoints">Temporary Breakpoints</a>
17614
<li>Breakpoint, toggling: <a href="#Tool%20Bar">Tool Bar</a>
17615
<li>Breakpoints, editing: <a href="#Editing%20all%20Breakpoints">Editing all Breakpoints</a>
17616
<li>Button editor: <a href="#Defining%20Buttons">Defining Buttons</a>
17617
<li>Button tip: <a href="#Getting%20Help">Getting Help</a>
17618
<li>Button tip, turning off: <a href="#Button%20tips">Button tips</a>
17619
<li>Buttons, defining: <a href="#Defining%20Buttons">Defining Buttons</a>
17620
<li>C: <a href="#Summary">Summary</a>
17621
<li>C++: <a href="#Summary">Summary</a>
17622
<li>Call stack: <a href="#Stack">Stack</a>
17623
<li>Chill: <a href="#Summary">Summary</a>
17624
<li>Class, opening: <a href="#Opening%20Programs">Opening Programs</a>
17625
<li>Clipboard: <a href="#Edit%20Menu">Edit Menu</a>
17626
<li>Clipboard, putting displays: <a href="#Deleting%20Displays">Deleting Displays</a>
17627
<li>Cluster: <a href="#Clustering">Clustering</a>
17628
<li>Cluster, and plotting: <a href="#Scalars%20and%20Composites">Scalars and Composites</a>
17629
<li>Clustered display, creating: <a href="#Creating%20Single%20Displays">Creating Single Displays</a>
17630
<li>Command completion: <a href="#Command%20Completion">Command Completion</a>
17631
<li>Command history: <a href="#Command%20History">Command History</a>
17632
<li>Command tool: <a href="#Windows">Windows</a>
17633
<li>Command, argument: <a href="#GDB%20Argument%20Commands">GDB Argument Commands</a>
17634
<li>Command, auto: <a href="#Commands%20with%20Other%20Debuggers">Commands with Other Debuggers</a>
17635
<li>Command, breakpoint: <a href="#Breakpoint%20Commands">Breakpoint Commands</a>
17636
<li>Command, defining: <a href="#Defining%20Commands">Defining Commands</a>
17637
<li>Command, defining in <small>GDB</small>: <a href="#GDB%20Simple%20Commands">GDB Simple Commands</a>
17638
<li>Command, defining with other debuggers: <a href="#Commands%20with%20Other%20Debuggers">Commands with Other Debuggers</a>
17639
<li>Command, recording: <a href="#GDB%20Simple%20Commands">GDB Simple Commands</a>
17640
<li>Command, repeating: <a href="#Command%20History">Command History</a>
17641
<li>Command, searching: <a href="#Command%20History">Command History</a>
17642
<li>Command, user-defined: <a href="#Defining%20Commands">Defining Commands</a>
17643
<li>Command-line debugger: <a href="#Summary">Summary</a>
17644
<li>Compact Layout: <a href="#Automatic%20Layout">Automatic Layout</a>
17645
<li>Completion of commands: <a href="#Command%20Completion">Command Completion</a>
17646
<li>Completion of quoted strings: <a href="#Command%20Completion">Command Completion</a>
17647
<li>Conditions on breakpoints: <a href="#Breakpoint%20Conditions">Breakpoint Conditions</a>
17648
<li>Context-sensitive help: <a href="#Getting%20Help">Getting Help</a>
17649
<li>Continue, at different address: <a href="#Continuing%20Somewhere%20Else">Continuing Somewhere Else</a>
17650
<li>Continue, one line: <a href="#Resuming%20Execution">Resuming Execution</a>
17651
<li>Continue, to location: <a href="#Resuming%20Execution">Resuming Execution</a>
17652
<li>Continue, to next line: <a href="#Resuming%20Execution">Resuming Execution</a>
17653
<li>Continue, until function returns: <a href="#Resuming%20Execution">Resuming Execution</a>
17654
<li>Continue, until greater line is reached: <a href="#Resuming%20Execution">Resuming Execution</a>
17655
<li>Continuing execution: <a href="#Resuming%20Execution">Resuming Execution</a>
17656
<li>Continuing process execution: <a href="#Attaching%20to%20a%20Process">Attaching to a Process</a>
17657
<li>Contour lines, in plots: <a href="#Plot%20Appearance">Plot Appearance</a>
17658
<li>Contributors: <a href="#Contributors">Contributors</a>
17659
<li>Copying displays: <a href="#Deleting%20Displays">Deleting Displays</a>
17660
<li>Core dump, opening: <a href="#Opening%20Core%20Dumps">Opening Core Dumps</a>
17661
<li>Core file, in sessions: <a href="#Saving%20Sessions">Saving Sessions</a>
17662
<li>Cutting displays: <a href="#Deleting%20Displays">Deleting Displays</a>
17663
<li>Data Theme: <a href="#Using%20Data%20Themes">Using Data Themes</a>
17664
<li>Data Window: <a href="#Displaying%20Values">Displaying Values</a>
17665
<li>Data window: <a href="#Windows">Windows</a>
17666
<li><small>DBX</small>: <a href="#Summary">Summary</a>
17667
<li><small>DBX</small>, invoking <small>DDD</small> with: <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>
17668
<li>Debugger console: <a href="#Windows">Windows</a>
17669
<li>Debugger, on remote host: <a href="#Remote%20Debugger">Remote Debugger</a>
17670
<li>Debugging <small>DDD</small>: <a href="#Debugging%20%3csmall%3eDDD%3c%2fsmall%3e">Debugging <small>DDD</small></a>
17671
<li>Debugging flags: <a href="#Patching">Patching</a>
17672
<li>Debugging optimized code: <a href="#Compiling%20for%20Debugging">Compiling for Debugging</a>
17673
<li>Default session: <a href="#Resuming%20Sessions">Resuming Sessions</a>
17674
<li>Deferred display: <a href="#Creating%20Single%20Displays">Creating Single Displays</a>
17675
<li>Deferred display, in sessions: <a href="#Saving%20Sessions">Saving Sessions</a>
17676
<li>Deleting displays: <a href="#Deleting%20Displays">Deleting Displays</a>, <a href="#Tool%20Bar">Tool Bar</a>
17677
<li>Deleting displays, undoing: <a href="#Deleting%20Displays">Deleting Displays</a>
17678
<li>Dependent display: <a href="#Creating%20Single%20Displays">Creating Single Displays</a>
17679
<li>Dereferencing: <a href="#Dereferencing%20Pointers">Dereferencing Pointers</a>
17680
<li>Detail toggling with <code>Show/Hide</code>: <a href="#Tool%20Bar">Tool Bar</a>
17681
<li>Detail, hiding: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17682
<li>Detail, showing: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17683
<li>Directory, of the debugged program: <a href="#Working%20Directory">Working Directory</a>
17684
<li>Disabled displays: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17685
<li>Disabling displays, undoing: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17686
<li>Display: <a href="#Displaying%20Values">Displaying Values</a>
17687
<li>Display Editor: <a href="#Editing%20all%20Displays">Editing all Displays</a>
17688
<li>Display name: <a href="#Selecting%20Displays">Selecting Displays</a>
17689
<li>Display position: <a href="#Creating%20Single%20Displays">Creating Single Displays</a>
17690
<li>Display selection: <a href="#Selecting%20Displays">Selecting Displays</a>
17691
<li>Display title: <a href="#Selecting%20Displays">Selecting Displays</a>
17692
<li>Display value: <a href="#Selecting%20Displays">Selecting Displays</a>
17693
<li>Display, aligning on grid: <a href="#Aligning%20Displays">Aligning Displays</a>
17694
<li>Display, clustered: <a href="#Creating%20Single%20Displays">Creating Single Displays</a>
17695
<li>Display, clustering: <a href="#Clustering">Clustering</a>
17696
<li>Display, copying: <a href="#Deleting%20Displays">Deleting Displays</a>
17697
<li>Display, creating: <a href="#Creating%20Single%20Displays">Creating Single Displays</a>, <a href="#Tool%20Bar">Tool Bar</a>
17698
<li>Display, customizing: <a href="#Customizing%20Displays">Customizing Displays</a>
17699
<li>Display, cutting: <a href="#Deleting%20Displays">Deleting Displays</a>
17700
<li>Display, deferred: <a href="#Creating%20Single%20Displays">Creating Single Displays</a>
17701
<li>Display, deleting: <a href="#Deleting%20Displays">Deleting Displays</a>, <a href="#Tool%20Bar">Tool Bar</a>
17702
<li>Display, dependent: <a href="#Dependent%20Values">Dependent Values</a>, <a href="#Creating%20Single%20Displays">Creating Single Displays</a>
17703
<li>Display, disabled: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17704
<li>Display, frozen: <a href="#Stopping%20X%20Programs">Stopping X Programs</a>
17705
<li>Display, hiding details: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17706
<li>Display, locked: <a href="#Stopping%20X%20Programs">Stopping X Programs</a>
17707
<li>Display, moving: <a href="#Moving%20Displays">Moving Displays</a>
17708
<li>Display, pasting: <a href="#Deleting%20Displays">Deleting Displays</a>
17709
<li>Display, placement: <a href="#Placement">Placement</a>
17710
<li>Display, plotting the history: <a href="#Plotting%20Histories">Plotting Histories</a>
17711
<li>Display, refreshing: <a href="#Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>
17712
<li>Display, rotating: <a href="#Rotating%20Displays">Rotating Displays</a>, <a href="#Tool%20Bar">Tool Bar</a>
17713
<li>Display, selecting: <a href="#Selecting%20Displays">Selecting Displays</a>
17714
<li>Display, setting: <a href="#Tool%20Bar">Tool Bar</a>, <a href="#Remote%20Host">Remote Host</a>
17715
<li>Display, setting when invoking <small>DDD</small>: <a href="#X%20Options">X Options</a>
17716
<li>Display, showing details: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17717
<li>Display, suppressing: <a href="#Deleting%20Displays">Deleting Displays</a>
17718
<li>Display, toggling detail: <a href="#Tool%20Bar">Tool Bar</a>
17719
<li>Display, updating: <a href="#Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>
17720
<li>Displaying values: <a href="#Displaying%20Values">Displaying Values</a>, <a href="#Examining%20Data">Examining Data</a>
17721
<li>Displaying values with <code>Display</code>: <a href="#Tool%20Bar">Tool Bar</a>
17722
<li>Dumping values: <a href="#Examining%20Data">Examining Data</a>
17723
<li>Edge: <a href="#Dependent%20Values">Dependent Values</a>
17724
<li>Edge hint: <a href="#Automatic%20Layout">Automatic Layout</a>, <a href="#Shared%20Structures">Shared Structures</a>
17725
<li>Editing source code: <a href="#Editing%20Source%20Code">Editing Source Code</a>
17726
<li>Emacs, integrating <small>DDD</small>: <a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>
17727
<li>Emergency repairs: <a href="#Patching">Patching</a>
17728
<li>Environment, of the debugged program: <a href="#Environment">Environment</a>
17729
<li><small>EPROM</small> code debugging: <a href="#Hardware-Assisted%20Breakpoints">Hardware-Assisted Breakpoints</a>
17730
<li>Examining memory contents: <a href="#Examining%20Memory">Examining Memory</a>
17731
<li>Execution position, dragging: <a href="#Continuing%20Somewhere%20Else">Continuing Somewhere Else</a>
17732
<li>Execution window: <a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>, <a href="#Windows">Windows</a>
17733
<li>Execution, "undoing": <a href="#Undoing%20Program%20Execution">Undoing Program Execution</a>
17734
<li>Execution, aborting: <a href="#Program%20Menu">Program Menu</a>, <a href="#Quitting">Quitting</a>
17735
<li>Execution, at different address: <a href="#Continuing%20Somewhere%20Else">Continuing Somewhere Else</a>
17736
<li>Execution, continuing: <a href="#Resuming%20Execution">Resuming Execution</a>
17737
<li>Execution, interrupting: <a href="#Quitting">Quitting</a>
17738
<li>Execution, interrupting automatically: <a href="#Debugger%20Communication">Debugger Communication</a>
17739
<li>Execution, one line: <a href="#Resuming%20Execution">Resuming Execution</a>
17740
<li>Execution, to location: <a href="#Resuming%20Execution">Resuming Execution</a>
17741
<li>Execution, to next line: <a href="#Resuming%20Execution">Resuming Execution</a>
17742
<li>Execution, until function returns: <a href="#Resuming%20Execution">Resuming Execution</a>
17743
<li>Execution, until greater line is reached: <a href="#Resuming%20Execution">Resuming Execution</a>
17744
<li>Exiting: <a href="#Quitting">Quitting</a>
17745
<li>Extending display selection: <a href="#Selecting%20Displays">Selecting Displays</a>
17746
<li>FIG file, printing as: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17747
<li>Files, opening: <a href="#Opening%20Files">Opening Files</a>
17748
<li>Finding items: <a href="#Tool%20Bar">Tool Bar</a>
17749
<li>Fonts: <a href="#Customizing%20Fonts">Customizing Fonts</a>
17750
<li>FORTRAN: <a href="#Summary">Summary</a>
17751
<li>Frame: <a href="#Frames">Frames</a>, <a href="#Stack">Stack</a>
17752
<li>Frame changes, undoing: <a href="#Selecting%20a%20frame">Selecting a frame</a>
17753
<li>Frame number: <a href="#Frames">Frames</a>
17754
<li>Frame pointer: <a href="#Frames">Frames</a>
17755
<li>Frame, selecting: <a href="#Selecting%20a%20frame">Selecting a frame</a>
17756
<li>GCC: <a href="#Compiling%20for%20Debugging">Compiling for Debugging</a>
17757
<li><small>GDB</small>: <a href="#Summary">Summary</a>
17758
<li><small>GDB</small>, invoking <small>DDD</small> with: <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>
17759
<li>Glyph: <a href="#Customizing%20Glyphs">Customizing Glyphs</a>
17760
<li>GPL: <a href="#Free%20Software">Free Software</a>
17761
<li>Grabbed pointer: <a href="#Stopping%20X%20Programs">Stopping X Programs</a>
17762
<li>Graph, printing: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17763
<li>Graph, rotating: <a href="#Rotating%20the%20Graph">Rotating the Graph</a>
17764
<li>Grid, aligning displays: <a href="#Aligning%20Displays">Aligning Displays</a>
17765
<li>Grid, in plots: <a href="#Plot%20Appearance">Plot Appearance</a>
17766
<li>Help: <a href="#Help%20and%20Assistance">Help and Assistance</a>, <a href="#Getting%20Help">Getting Help</a>
17767
<li>Help, in the status line: <a href="#Getting%20Help">Getting Help</a>
17768
<li>Help, on buttons: <a href="#Getting%20Help">Getting Help</a>
17769
<li>Help, on commands: <a href="#Getting%20Help">Getting Help</a>
17770
<li>Help, on items: <a href="#Getting%20Help">Getting Help</a>
17771
<li>Help, when stuck: <a href="#Getting%20Help">Getting Help</a>
17772
<li>Hiding display details: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17773
<li>Historic mode: <a href="#Undoing%20Program%20Execution">Undoing Program Execution</a>
17774
<li>History: <a href="#History">History</a>
17775
<li>History, plotting: <a href="#Plotting%20Histories">Plotting Histories</a>
17776
<li>Host, remote: <a href="#Remote%20Host">Remote Host</a>
17777
<li>HTML manual: <a href="#About%20this%20Manual">About this Manual</a>
17778
<li>IBMGL file, printing as: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17779
<li>Icon, invoking <small>DDD</small> as: <a href="#X%20Options">X Options</a>
17780
<li>Ignore count: <a href="#Breakpoint%20Ignore%20Counts">Breakpoint Ignore Counts</a>
17781
<li>Indent, source code: <a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
17782
<li>Inferior debugger: <a href="#Summary">Summary</a>
17783
<li>Info manual: <a href="#About%20this%20Manual">About this Manual</a>
17784
<li>Initial frame: <a href="#Frames">Frames</a>
17785
<li>Innermost frame: <a href="#Frames">Frames</a>
17786
<li>Input of the debugged program: <a href="#Input%2fOutput">Input/Output</a>
17787
<li>Instruction, stepping: <a href="#Machine%20Code%20Execution">Machine Code Execution</a>
17788
<li>Integrating <small>DDD</small>: <a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>
17789
<li>Interrupting <small>DDD</small>: <a href="#Quitting">Quitting</a>
17790
<li>Interrupting execution: <a href="#Quitting">Quitting</a>
17791
<li>Interrupting execution, automatically: <a href="#Debugger%20Communication">Debugger Communication</a>
17792
<li>Invoking: <a href="#Invoking">Invoking</a>
17793
<li>Java: <a href="#Summary">Summary</a>
17794
<li><small>JDB</small>: <a href="#Summary">Summary</a>
17795
<li><small>JDB</small>, invoking <small>DDD</small> with: <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>
17796
<li>Jump to different address: <a href="#Continuing%20Somewhere%20Else">Continuing Somewhere Else</a>
17797
<li>Killing <small>DDD</small>: <a href="#Quitting">Quitting</a>
17798
<li>Killing the debugged program: <a href="#Killing%20the%20Program">Killing the Program</a>
17799
<li>Ladebug: <a href="#Summary">Summary</a>
17800
<li>Ladebug, invoking <small>DDD</small> with: <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>
17801
<li>License: <a href="#License">License</a>, <a href="#Free%20Software">Free Software</a>
17802
<li>License, Documentation: <a href="#Documentation%20License">Documentation License</a>
17803
<li>License, showing on standard output: <a href="#Options">Options</a>
17804
<li>Line numbers: <a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
17805
<li>Local variables, displaying: <a href="#Displaying%20Local%20Variables">Displaying Local Variables</a>
17806
<li>Logging: <a href="#Logging">Logging</a>
17807
<li>Logging, disabling: <a href="#Disabling%20Logging">Disabling Logging</a>
17808
<li>Looking up breakpoints: <a href="#Looking%20up%20Breakpoints">Looking up Breakpoints</a>
17809
<li>Looking up items: <a href="#Tool%20Bar">Tool Bar</a>
17810
<li>Lookups, redoing: <a href="#Looking%20up%20Previous%20Locations">Looking up Previous Locations</a>
17811
<li>Lookups, undoing: <a href="#Looking%20up%20Previous%20Locations">Looking up Previous Locations</a>
17812
<li>L�tkehaus, Dorothea: <a href="#History">History</a>, <a href="#Contributors">Contributors</a>
17813
<li>Machine code window: <a href="#Windows">Windows</a>
17814
<li>Machine code, examining: <a href="#Machine%20Code">Machine Code</a>
17815
<li>Machine code, executing: <a href="#Machine%20Code%20Execution">Machine Code Execution</a>
17816
<li>Mailing list: <a href="#Help%20and%20Assistance">Help and Assistance</a>
17817
<li>Make, invoking: <a href="#Recompiling">Recompiling</a>
17818
<li>Manual, showing on standard output: <a href="#Options">Options</a>
17819
<li>Memory, dumping contents: <a href="#Examining%20Data">Examining Data</a>
17820
<li>Memory, examining: <a href="#Examining%20Memory">Examining Memory</a>
17821
<li>Modula-2: <a href="#Summary">Summary</a>
17822
<li>Modula-3: <a href="#Summary">Summary</a>
17823
<li>Mouse pointer, frozen: <a href="#Stopping%20X%20Programs">Stopping X Programs</a>
17824
<li>Name, display: <a href="#Selecting%20Displays">Selecting Displays</a>
17825
<li>News, showing on standard output: <a href="#Options">Options</a>
17826
<li>NORA: <a href="#History">History</a>
17827
<li>Optimized code, debugging: <a href="#Compiling%20for%20Debugging">Compiling for Debugging</a>
17828
<li>Option: <a href="#Invoking">Invoking</a>
17829
<li>Outermost frame: <a href="#Frames">Frames</a>
17830
<li>Output of the debugged program: <a href="#Input%2fOutput">Input/Output</a>
17831
<li>Pascal: <a href="#Summary">Summary</a>
17832
<li>Pasting displays: <a href="#Deleting%20Displays">Deleting Displays</a>
17833
<li>Patching: <a href="#Patching">Patching</a>
17834
<li>PDF manual: <a href="#About%20this%20Manual">About this Manual</a>
17835
<li>Perl: <a href="#Summary">Summary</a>
17836
<li>Perl, invoking <small>DDD</small> with: <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>
17837
<li>PIC file, printing as: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17838
<li>Pipe: <a href="#Input%2fOutput">Input/Output</a>
17839
<li>Placement: <a href="#Placement">Placement</a>
17840
<li>Plot appearance: <a href="#Plot%20Appearance">Plot Appearance</a>
17841
<li>Plot, animating: <a href="#Animating%20Plots">Animating Plots</a>
17842
<li>Plot, exporting: <a href="#Exporting%20Plot%20Data">Exporting Plot Data</a>
17843
<li>Plot, printing: <a href="#Printing%20Plots">Printing Plots</a>
17844
<li>Plot, scrolling: <a href="#Plot%20Appearance">Plot Appearance</a>
17845
<li>Plotting style: <a href="#Plot%20Appearance">Plot Appearance</a>
17846
<li>Plotting values: <a href="#Plotting%20Values">Plotting Values</a>, <a href="#Examining%20Data">Examining Data</a>, <a href="#Tool%20Bar">Tool Bar</a>
17847
<li>Pointers, dereferencing: <a href="#Dereferencing%20Pointers">Dereferencing Pointers</a>
17848
<li>Position, of display: <a href="#Creating%20Single%20Displays">Creating Single Displays</a>
17849
<li>PostScript manual: <a href="#About%20this%20Manual">About this Manual</a>
17850
<li>PostScript, printing as: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17851
<li>Print, output formats: <a href="#Printing%20Values">Printing Values</a>
17852
<li>Printing plots: <a href="#Printing%20Plots">Printing Plots</a>
17853
<li>Printing the Graph: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17854
<li>Printing values: <a href="#Printing%20Values">Printing Values</a>, <a href="#Examining%20Data">Examining Data</a>
17855
<li>Printing values with <code>Print</code>: <a href="#Tool%20Bar">Tool Bar</a>
17856
<li>Process, attaching: <a href="#Attaching%20to%20a%20Process">Attaching to a Process</a>
17857
<li>Program arguments: <a href="#Starting%20Program%20Execution">Starting Program Execution</a>
17858
<li>Program counter, displaying: <a href="#Machine%20Code%20Execution">Machine Code Execution</a>
17859
<li>Program output, confusing: <a href="#Input%2fOutput">Input/Output</a>
17860
<li>Program, on remote host: <a href="#Remote%20Program">Remote Program</a>
17861
<li>Program, opening: <a href="#Opening%20Programs">Opening Programs</a>
17862
<li>Program, patching: <a href="#Patching">Patching</a>
17863
<li>PSG: <a href="#History">History</a>
17864
<li><small>PYDB</small>: <a href="#Summary">Summary</a>
17865
<li><small>PYDB</small>, invoking <small>DDD</small> with: <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>
17866
<li>Python: <a href="#Summary">Summary</a>
17867
<li>Quitting: <a href="#Quitting">Quitting</a>
17868
<li>Quotes in commands: <a href="#Command%20Completion">Command Completion</a>
17869
<li>Readline: <a href="#TTY%20mode">TTY mode</a>
17870
<li>Recompiling: <a href="#Recompiling">Recompiling</a>
17871
<li>Recording commands: <a href="#GDB%20Simple%20Commands">GDB Simple Commands</a>
17872
<li>Redirecting I/O of the debugged program: <a href="#Input%2fOutput">Input/Output</a>
17873
<li>Redirecting I/O to the execution window: <a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>
17874
<li>Redirection: <a href="#Input%2fOutput">Input/Output</a>
17875
<li>Redirection, to execution window: <a href="#Using%20the%20Execution%20Window">Using the Execution Window</a>, <a href="#Debugger%20Communication">Debugger Communication</a>
17876
<li>Redoing commands: <a href="#Undo%20and%20Redo">Undo and Redo</a>
17877
<li>Redoing lookups: <a href="#Looking%20up%20Previous%20Locations">Looking up Previous Locations</a>
17878
<li>Refreshing displayed values: <a href="#Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>
17879
<li>Registers, examining: <a href="#Registers">Registers</a>
17880
<li>Reloading source code: <a href="#Editing%20Source%20Code">Editing Source Code</a>
17881
<li>Remote debugger: <a href="#Remote%20Debugger">Remote Debugger</a>
17882
<li>Remote host: <a href="#Remote%20Host">Remote Host</a>
17883
<li>Remote program: <a href="#Remote%20Program">Remote Program</a>
17884
<li>Resource, setting when invoking <small>DDD</small>: <a href="#X%20Options">X Options</a>
17885
<li>Resources: <a href="#Resources">Resources</a>
17886
<li><small>ROM</small> code debugging: <a href="#Hardware-Assisted%20Breakpoints">Hardware-Assisted Breakpoints</a>
17887
<li>Rotating displays with <code>Rotate</code>: <a href="#Tool%20Bar">Tool Bar</a>
17888
<li>Rotating the graph: <a href="#Rotating%20the%20Graph">Rotating the Graph</a>
17889
<li>Running the debugged program: <a href="#Running">Running</a>
17890
<li>Scalars, plotting: <a href="#Scalars%20and%20Composites">Scalars and Composites</a>
17891
<li>Scales, in plots: <a href="#Plot%20Appearance">Plot Appearance</a>
17892
<li>Scrolling: <a href="#Scrolling%20Data">Scrolling Data</a>
17893
<li>Search, using <code>Find >></code>: <a href="#Tool%20Bar">Tool Bar</a>
17894
<li>Searching commands: <a href="#Command%20History">Command History</a>
17895
<li>Selecting frames: <a href="#Selecting%20a%20frame">Selecting a frame</a>
17896
<li>Selecting multiple displays: <a href="#Selecting%20Displays">Selecting Displays</a>
17897
<li>Selecting single displays: <a href="#Selecting%20Displays">Selecting Displays</a>
17898
<li>Session: <a href="#Sessions">Sessions</a>
17899
<li>Session, active: <a href="#Saving%20Sessions">Saving Sessions</a>
17900
<li>Session, default: <a href="#Resuming%20Sessions">Resuming Sessions</a>
17901
<li>Session, deleting: <a href="#Deleting%20Sessions">Deleting Sessions</a>
17902
<li>Session, opening: <a href="#Resuming%20Sessions">Resuming Sessions</a>
17903
<li>Session, resuming: <a href="#Resuming%20Sessions">Resuming Sessions</a>
17904
<li>Session, saving: <a href="#Saving%20Sessions">Saving Sessions</a>
17905
<li>Session, setting when invoking <small>DDD</small>: <a href="#Options">Options</a>
17906
<li>Setting variables: <a href="#Assignment">Assignment</a>
17907
<li>Setting variables with <code>Set</code>: <a href="#Tool%20Bar">Tool Bar</a>
17908
<li>Shared structures, detecting: <a href="#Shared%20Structures">Shared Structures</a>
17909
<li>Showing display details: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17910
<li>SIGABRT signal: <a href="#Program%20Menu">Program Menu</a>, <a href="#Quitting">Quitting</a>
17911
<li>SIGALRM signal: <a href="#Signals">Signals</a>
17912
<li>SIGINT signal: <a href="#Signals">Signals</a>, <a href="#Interrupting">Interrupting</a>
17913
<li>Signal settings, editing: <a href="#Signals">Signals</a>
17914
<li>Signal settings, saving: <a href="#Signals">Signals</a>
17915
<li>Signal, fatal: <a href="#Signals">Signals</a>
17916
<li>Signal, sending to <small>DDD</small>: <a href="#Quitting">Quitting</a>
17917
<li>Signals: <a href="#Signals">Signals</a>
17918
<li>SIGSEGV signal: <a href="#Signals">Signals</a>
17919
<li>SIGTRAP signal: <a href="#Signals">Signals</a>
17920
<li>SIGUSR1 signal: <a href="#Debugging%20%3csmall%3eDDD%3c%2fsmall%3e">Debugging <small>DDD</small></a>, <a href="#Maintenance%20Menu">Maintenance Menu</a>
17921
<li>Source code, editing: <a href="#Editing%20Source%20Code">Editing Source Code</a>
17922
<li>Source code, recompiling: <a href="#Recompiling">Recompiling</a>
17923
<li>Source code, reloading: <a href="#Editing%20Source%20Code">Editing Source Code</a>
17924
<li>Source directory: <a href="#Source%20Path">Source Path</a>
17925
<li>Source file, opening: <a href="#Opening%20Source%20Files">Opening Source Files</a>
17926
<li>Source file, typing into: <a href="#Typing%20in%20the%20Source%20Window">Typing in the Source Window</a>
17927
<li>Source path: <a href="#Source%20Path">Source Path</a>
17928
<li>Source path, specifying: <a href="#Source%20Path">Source Path</a>
17929
<li>Source window: <a href="#Windows">Windows</a>
17930
<li>Source, accessing: <a href="#Source%20Path">Source Path</a>
17931
<li>Stack Frame: <a href="#Frames">Frames</a>
17932
<li>Stack frame: <a href="#Stack">Stack</a>
17933
<li>Stack, moving within: <a href="#Selecting%20a%20frame">Selecting a frame</a>
17934
<li>Status display: <a href="#Displaying%20Program%20Status">Displaying Program Status</a>
17935
<li>Status line: <a href="#Getting%20Help">Getting Help</a>
17936
<li>Status line, location: <a href="#Window%20Layout">Window Layout</a>
17937
<li>Suppressing values: <a href="#Deleting%20Displays">Deleting Displays</a>
17938
<li>Tab width: <a href="#Customizing%20Source%20Appearance">Customizing Source Appearance</a>
17939
<li>TeX file, printing as: <a href="#Printing%20the%20Graph">Printing the Graph</a>
17940
<li>TeXinfo manual: <a href="#About%20this%20Manual">About this Manual</a>
17941
<li>Theme, Data: <a href="#Using%20Data%20Themes">Using Data Themes</a>
17942
<li>Theme, editing: <a href="#Editing%20Themes">Editing Themes</a>
17943
<li>Theme, for suppressing values: <a href="#Deleting%20Displays">Deleting Displays</a>
17944
<li>Threads: <a href="#Threads">Threads</a>
17945
<li>Tic Tac Toe game: <a href="#Maintenance%20Menu">Maintenance Menu</a>
17946
<li>Tip of the day: <a href="#Getting%20Help">Getting Help</a>
17947
<li>Tip of the day, turning off: <a href="#Tip%20of%20the%20day">Tip of the day</a>
17948
<li>Tip, on buttons: <a href="#Getting%20Help">Getting Help</a>
17949
<li>Tip, value: <a href="#Value%20Tips">Value Tips</a>, <a href="#Examining%20Data">Examining Data</a>
17950
<li>Title, display: <a href="#Selecting%20Displays">Selecting Displays</a>
17951
<li>Tool Bar, location: <a href="#Window%20Layout">Window Layout</a>
17952
<li>Tool tip: <a href="#Getting%20Help">Getting Help</a>
17953
<li>Tornado: <a href="#WindRiver%20GDB">WindRiver GDB</a>
17954
<li><small>TTY</small> interface: <a href="#TTY%20mode">TTY mode</a>
17955
<li><small>TTY</small> mode, setting when invoking <small>DDD</small>: <a href="#Options">Options</a>
17956
<li><small>TTY</small> settings: <a href="#Input%2fOutput">Input/Output</a>
17957
<li>Undo deleting displays: <a href="#Deleting%20Displays">Deleting Displays</a>
17958
<li>Undo disabling displays: <a href="#Showing%20and%20Hiding%20Details">Showing and Hiding Details</a>
17959
<li>Undoing commands: <a href="#Undo%20and%20Redo">Undo and Redo</a>
17960
<li>Undoing frame changes: <a href="#Selecting%20a%20frame">Selecting a frame</a>
17961
<li>Undoing lookups: <a href="#Looking%20up%20Previous%20Locations">Looking up Previous Locations</a>
17962
<li>Undoing program execution: <a href="#Undoing%20Program%20Execution">Undoing Program Execution</a>
17963
<li>Undoing signal handling: <a href="#Signals">Signals</a>
17964
<li>Updating displayed values: <a href="#Refreshing%20the%20Data%20Window">Refreshing the Data Window</a>
17965
<li>User-defined command: <a href="#Defining%20Commands">Defining Commands</a>
17966
<li>Value tip: <a href="#Value%20Tips">Value Tips</a>, <a href="#Examining%20Data">Examining Data</a>
17967
<li>Value, display: <a href="#Selecting%20Displays">Selecting Displays</a>
17968
<li>Value, displaying: <a href="#Displaying%20Values">Displaying Values</a>, <a href="#Examining%20Data">Examining Data</a>
17969
<li>Value, dumping: <a href="#Examining%20Data">Examining Data</a>
17970
<li>Value, plotting: <a href="#Examining%20Data">Examining Data</a>
17971
<li>Value, plotting the history: <a href="#Plotting%20Histories">Plotting Histories</a>
17972
<li>Value, printing: <a href="#Printing%20Values">Printing Values</a>, <a href="#Examining%20Data">Examining Data</a>
17973
<li>Values, displaying with <code>Display</code>: <a href="#Tool%20Bar">Tool Bar</a>
17974
<li>Values, plotting: <a href="#Plotting%20Values">Plotting Values</a>
17975
<li>Values, plotting with <code>Plot</code>: <a href="#Tool%20Bar">Tool Bar</a>
17976
<li>Values, printing with <code>Print</code>: <a href="#Tool%20Bar">Tool Bar</a>
17977
<li>Values, suppressing: <a href="#Deleting%20Displays">Deleting Displays</a>
17978
<li>Variables, setting: <a href="#Assignment">Assignment</a>
17979
<li>Variables, setting with <code>Set</code>: <a href="#Tool%20Bar">Tool Bar</a>
17980
<li>virtual machine: <a href="#JDB%20Options">JDB Options</a>
17981
<li>VM: <a href="#JDB%20Options">JDB Options</a>
17982
<li>VSL: <a href="#History">History</a>
17983
<li>Watchpoint: <a href="#Watchpoints">Watchpoints</a>, <a href="#Stopping">Stopping</a>
17984
<li>Watchpoint properties: <a href="#Editing%20Watchpoint%20Properties">Editing Watchpoint Properties</a>
17985
<li>Watchpoint, deleting: <a href="#Deleting%20Watchpoints">Deleting Watchpoints</a>
17986
<li>Watchpoint, editing: <a href="#Editing%20Watchpoint%20Properties">Editing Watchpoint Properties</a>
17987
<li>Watchpoint, setting: <a href="#Setting%20Watchpoints">Setting Watchpoints</a>
17988
<li>Watchpoint, toggling: <a href="#Tool%20Bar">Tool Bar</a>
17989
<li>Watchpoints, editing: <a href="#Editing%20all%20Watchpoints">Editing all Watchpoints</a>
17990
<li>WDB: <a href="#WDB">WDB</a>
17991
<li><small>WDB</small>, invoking <small>DDD</small> with: <a href="#WDB">WDB</a>, <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>
17992
<li>WildeBeest: <a href="#WDB">WDB</a>
17993
<li>WindRiver GDB: <a href="#WindRiver%20GDB">WindRiver GDB</a>
17994
<li>Working directory, of the debugged program: <a href="#Working%20Directory">Working Directory</a>
17995
<li>X programs, stopping: <a href="#Stopping%20X%20Programs">Stopping X Programs</a>
17996
<li>X server, frozen: <a href="#Stopping%20X%20Programs">Stopping X Programs</a>
17997
<li>X server, locked: <a href="#Stopping%20X%20Programs">Stopping X Programs</a>
17998
<li>X session: <a href="#Resuming%20Sessions">Resuming Sessions</a>
17999
<li>X Warnings, suppressing: <a href="#X%20Warnings">X Warnings</a>
18000
<li><small>XDB</small>: <a href="#Summary">Summary</a>
18001
<li><small>XDB</small>, invoking <small>DDD</small> with: <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>
18002
<li>XEmacs, integrating <small>DDD</small>: <a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>
18003
<li><small>XXGDB</small>, integrating <small>DDD</small>: <a href="#Integrating%20%3csmall%3eDDD%3c%2fsmall%3e">Integrating <small>DDD</small></a>
18004
<li>Zeller, Andreas: <a href="#History">History</a>, <a href="#Contributors">Contributors</a>
18005
</ul>
18006
18007
18008
<div class="footnote">
15460
<li><a href="#index-Aborting-execution-317">Aborting execution</a>: <a href="#Program-Menu">Program Menu</a></li>
15461
<li><a href="#index-Aborting-execution-105">Aborting execution</a>: <a href="#Quitting">Quitting</a></li>
15462
<li><a href="#index-Ada-10">Ada</a>: <a href="#Summary">Summary</a></li>
15463
<li><a href="#index-Aliases_002c-detecting-1015">Aliases, detecting</a>: <a href="#Shared-Structures">Shared Structures</a></li>
15464
<li><a href="#index-Animating-plots-1137">Animating plots</a>: <a href="#Animating-Plots">Animating Plots</a></li>
15465
<li><a href="#index-Arguments_002c-displaying-947">Arguments, displaying</a>: <a href="#Displaying-Local-Variables">Displaying Local Variables</a></li>
15466
<li><a href="#index-Arguments_002c-of-the-debugged-program-750">Arguments, of the debugged program</a>: <a href="#Arguments">Arguments</a></li>
15467
<li><a href="#index-Arguments_002c-program-744">Arguments, program</a>: <a href="#Starting-Program-Execution">Starting Program Execution</a></li>
15468
<li><a href="#index-Array-slices-994">Array slices</a>: <a href="#Array-Slices">Array Slices</a></li>
15469
<li><a href="#index-Array_002c-artificial-995">Array, artificial</a>: <a href="#Array-Slices">Array Slices</a></li>
15470
<li><a href="#index-Array_002c-plotting-1102">Array, plotting</a>: <a href="#Plotting-Arrays">Plotting Arrays</a></li>
15471
<li><a href="#index-Artificial-arrays-996">Artificial arrays</a>: <a href="#Array-Slices">Array Slices</a></li>
15472
<li><a href="#index-Assertions-and-breakpoints-692">Assertions and breakpoints</a>: <a href="#Breakpoint-Conditions">Breakpoint Conditions</a></li>
15473
<li><a href="#index-Assertions-and-watchpoints-714">Assertions and watchpoints</a>: <a href="#Watchpoints">Watchpoints</a></li>
15474
<li><a href="#index-Assignment-1002">Assignment</a>: <a href="#Assignment">Assignment</a></li>
15475
<li><a href="#index-Assistance-1393">Assistance</a>: <a href="#Help-and-Assistance">Help and Assistance</a></li>
15476
<li><a href="#index-Auto_002dcommand-1251">Auto-command</a>: <a href="#Commands-with-Other-Debuggers">Commands with Other Debuggers</a></li>
15477
<li><a href="#index-Automatic-Layout-1077">Automatic Layout</a>: <a href="#Automatic-Layout">Automatic Layout</a></li>
15478
<li><a href="#index-Balloon-help-509">Balloon help</a>: <a href="#Getting-Help">Getting Help</a></li>
15479
<li><a href="#index-Bash-17">Bash</a>: <a href="#Summary">Summary</a></li>
15480
<li><a href="#index-Bash_002c-invoking-_0040DDD_007b_007d-with-53">Bash, invoking <acronym>DDD</acronym> with</a>: <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a></li>
15481
<li><a href="#index-Box-library-45">Box library</a>: <a href="#History">History</a></li>
15482
<li><a href="#index-Breakpoint-664">Breakpoint</a>: <a href="#Stopping">Stopping</a></li>
15483
<li><a href="#index-Breakpoint-commands-697">Breakpoint commands</a>: <a href="#Breakpoint-Commands">Breakpoint Commands</a></li>
15484
<li><a href="#index-Breakpoint-commands_002c-vs_002e-conditions-693">Breakpoint commands, vs. conditions</a>: <a href="#Breakpoint-Conditions">Breakpoint Conditions</a></li>
15485
<li><a href="#index-Breakpoint-conditions-691">Breakpoint conditions</a>: <a href="#Breakpoint-Conditions">Breakpoint Conditions</a></li>
15486
<li><a href="#index-Breakpoint-ignore-counts-694">Breakpoint ignore counts</a>: <a href="#Breakpoint-Ignore-Counts">Breakpoint Ignore Counts</a></li>
15487
<li><a href="#index-Breakpoint-properties-683">Breakpoint properties</a>: <a href="#Editing-Breakpoint-Properties">Editing Breakpoint Properties</a></li>
15488
<li><a href="#index-Breakpoint_002c-copying-703">Breakpoint, copying</a>: <a href="#Moving-and-Copying-Breakpoints">Moving and Copying Breakpoints</a></li>
15489
<li><a href="#index-Breakpoint_002c-deleting-669">Breakpoint, deleting</a>: <a href="#Deleting-Breakpoints">Deleting Breakpoints</a></li>
15490
<li><a href="#index-Breakpoint_002c-disabling-673">Breakpoint, disabling</a>: <a href="#Disabling-Breakpoints">Disabling Breakpoints</a></li>
15491
<li><a href="#index-Breakpoint_002c-dragging-704">Breakpoint, dragging</a>: <a href="#Moving-and-Copying-Breakpoints">Moving and Copying Breakpoints</a></li>
15492
<li><a href="#index-Breakpoint_002c-editing-684">Breakpoint, editing</a>: <a href="#Editing-Breakpoint-Properties">Editing Breakpoint Properties</a></li>
15493
<li><a href="#index-Breakpoint_002c-enabling-674">Breakpoint, enabling</a>: <a href="#Disabling-Breakpoints">Disabling Breakpoints</a></li>
15494
<li><a href="#index-Breakpoint_002c-hardware_002dassisted-708">Breakpoint, hardware-assisted</a>: <a href="#Hardware_002dAssisted-Breakpoints">Hardware-Assisted Breakpoints</a></li>
15495
<li><a href="#index-Breakpoint_002c-looking-up-705">Breakpoint, looking up</a>: <a href="#Looking-up-Breakpoints">Looking up Breakpoints</a></li>
15496
<li><a href="#index-Breakpoint_002c-moving-702">Breakpoint, moving</a>: <a href="#Moving-and-Copying-Breakpoints">Moving and Copying Breakpoints</a></li>
15497
<li><a href="#index-Breakpoint_002c-setting-666">Breakpoint, setting</a>: <a href="#Setting-Breakpoints">Setting Breakpoints</a></li>
15498
<li><a href="#index-Breakpoint_002c-temporary-680">Breakpoint, temporary</a>: <a href="#Temporary-Breakpoints">Temporary Breakpoints</a></li>
15499
<li><a href="#index-Breakpoint_002c-toggling-445">Breakpoint, toggling</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15500
<li><a href="#index-Breakpoints_002c-editing-707">Breakpoints, editing</a>: <a href="#Editing-all-Breakpoints">Editing all Breakpoints</a></li>
15501
<li><a href="#index-Button-editor-1225">Button editor</a>: <a href="#Defining-Buttons">Defining Buttons</a></li>
15502
<li><a href="#index-Button-tip-507">Button tip</a>: <a href="#Getting-Help">Getting Help</a></li>
15503
<li><a href="#index-Button-tip_002c-turning-off-547">Button tip, turning off</a>: <a href="#Button-tips">Button tips</a></li>
15504
<li><a href="#index-Buttons_002c-defining-1224">Buttons, defining</a>: <a href="#Defining-Buttons">Defining Buttons</a></li>
15505
<li><a href="#index-C-4">C</a>: <a href="#Summary">Summary</a></li>
15506
<li><a href="#index-C_002b_002b-5">C++</a>: <a href="#Summary">Summary</a></li>
15507
<li><a href="#index-Call-stack-816">Call stack</a>: <a href="#Stack">Stack</a></li>
15508
<li><a href="#index-Chill-9">Chill</a>: <a href="#Summary">Summary</a></li>
15509
<li><a href="#index-Class_002c-opening-611">Class, opening</a>: <a href="#Opening-Programs">Opening Programs</a></li>
15510
<li><a href="#index-Clipboard-238">Clipboard</a>: <a href="#Edit-Menu">Edit Menu</a></li>
15511
<li><a href="#index-Clipboard_002c-putting-displays-990">Clipboard, putting displays</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15512
<li><a href="#index-Cluster-964">Cluster</a>: <a href="#Clustering">Clustering</a></li>
15513
<li><a href="#index-Cluster_002c-and-plotting-1117">Cluster, and plotting</a>: <a href="#Scalars-and-Composites">Scalars and Composites</a></li>
15514
<li><a href="#index-Clustered-display_002c-creating-896">Clustered display, creating</a>: <a href="#Creating-Single-Displays">Creating Single Displays</a></li>
15515
<li><a href="#index-Command-completion-1197">Command completion</a>: <a href="#Command-Completion">Command Completion</a></li>
15516
<li><a href="#index-Command-history-1203">Command history</a>: <a href="#Command-History">Command History</a></li>
15517
<li><a href="#index-Command-tool-202">Command tool</a>: <a href="#Windows">Windows</a></li>
15518
<li><a href="#index-Command_002c-argument-1247">Command, argument</a>: <a href="#GDB-Argument-Commands">GDB Argument Commands</a></li>
15519
<li><a href="#index-Command_002c-auto-1252">Command, auto</a>: <a href="#Commands-with-Other-Debuggers">Commands with Other Debuggers</a></li>
15520
<li><a href="#index-Command_002c-breakpoint-698">Command, breakpoint</a>: <a href="#Breakpoint-Commands">Breakpoint Commands</a></li>
15521
<li><a href="#index-Command_002c-defining-1234">Command, defining</a>: <a href="#Defining-Commands">Defining Commands</a></li>
15522
<li><a href="#index-Command_002c-defining-in-_0040GDB_007b_007d-1237">Command, defining in <acronym>GDB</acronym></a>: <a href="#GDB-Simple-Commands">GDB Simple Commands</a></li>
15523
<li><a href="#index-Command_002c-defining-with-other-debuggers-1250">Command, defining with other debuggers</a>: <a href="#Commands-with-Other-Debuggers">Commands with Other Debuggers</a></li>
15524
<li><a href="#index-Command_002c-recording-1241">Command, recording</a>: <a href="#GDB-Simple-Commands">GDB Simple Commands</a></li>
15525
<li><a href="#index-Command_002c-repeating-1201">Command, repeating</a>: <a href="#Command-History">Command History</a></li>
15526
<li><a href="#index-Command_002c-searching-1202">Command, searching</a>: <a href="#Command-History">Command History</a></li>
15527
<li><a href="#index-Command_002c-user_002ddefined-1235">Command, user-defined</a>: <a href="#Defining-Commands">Defining Commands</a></li>
15528
<li><a href="#index-Command_002dline-debugger-2">Command-line debugger</a>: <a href="#Summary">Summary</a></li>
15529
<li><a href="#index-Compact-Layout-1076">Compact Layout</a>: <a href="#Automatic-Layout">Automatic Layout</a></li>
15530
<li><a href="#index-Completion-of-commands-1196">Completion of commands</a>: <a href="#Command-Completion">Command Completion</a></li>
15531
<li><a href="#index-Completion-of-quoted-strings-1199">Completion of quoted strings</a>: <a href="#Command-Completion">Command Completion</a></li>
15532
<li><a href="#index-Conditions-on-breakpoints-690">Conditions on breakpoints</a>: <a href="#Breakpoint-Conditions">Breakpoint Conditions</a></li>
15533
<li><a href="#index-Context_002dsensitive-help-515">Context-sensitive help</a>: <a href="#Getting-Help">Getting Help</a></li>
15534
<li><a href="#index-Continue_002c-at-different-address-809">Continue, at different address</a>: <a href="#Continuing-Somewhere-Else">Continuing Somewhere Else</a></li>
15535
<li><a href="#index-Continue_002c-one-line-795">Continue, one line</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15536
<li><a href="#index-Continue_002c-to-location-801">Continue, to location</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15537
<li><a href="#index-Continue_002c-to-next-line-798">Continue, to next line</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15538
<li><a href="#index-Continue_002c-until-function-returns-806">Continue, until function returns</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15539
<li><a href="#index-Continue_002c-until-greater-line-is-reached-803">Continue, until greater line is reached</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15540
<li><a href="#index-Continuing-execution-791">Continuing execution</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15541
<li><a href="#index-Continuing-process-execution-784">Continuing process execution</a>: <a href="#Attaching-to-a-Process">Attaching to a Process</a></li>
15542
<li><a href="#index-Contour-lines_002c-in-plots-1114">Contour lines, in plots</a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
15543
<li><a href="#index-Contributors-35">Contributors</a>: <a href="#Contributors">Contributors</a></li>
15544
<li><a href="#index-Copying-displays-986">Copying displays</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15545
<li><a href="#index-Core-dump_002c-opening-616">Core dump, opening</a>: <a href="#Opening-Core-Dumps">Opening Core Dumps</a></li>
15546
<li><a href="#index-Core-file_002c-in-sessions-115">Core file, in sessions</a>: <a href="#Saving-Sessions">Saving Sessions</a></li>
15547
<li><a href="#index-Cutting-displays-984">Cutting displays</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15548
<li><a href="#index-Data-Theme-1033">Data Theme</a>: <a href="#Using-Data-Themes">Using Data Themes</a></li>
15549
<li><a href="#index-Data-Window-886">Data Window</a>: <a href="#Displaying-Values">Displaying Values</a></li>
15550
<li><a href="#index-Data-window-199">Data window</a>: <a href="#Windows">Windows</a></li>
15551
<li><a href="#index-g_t_0040acronym_007bDBX_007d-12"><acronym>DBX</acronym></a>: <a href="#Summary">Summary</a></li>
15552
<li><a href="#index-g_t_0040acronym_007bDBX_007d_002c-invoking-_0040DDD_007b_007d-with-58"><acronym>DBX</acronym>, invoking <acronym>DDD</acronym> with</a>: <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a></li>
15553
<li><a href="#index-Debugger-console-201">Debugger console</a>: <a href="#Windows">Windows</a></li>
15554
<li><a href="#index-Debugger_002c-on-remote-host-138">Debugger, on remote host</a>: <a href="#Remote-Debugger">Remote Debugger</a></li>
15555
<li><a href="#index-Debugging-_0040DDD_007b_007d-1362">Debugging <acronym>DDD</acronym></a>: <a href="#Debugging-_003cacronym_003eDDD_003c_002facronym_003e">Debugging <acronym>DDD</acronym></a></li>
15556
<li><a href="#index-Debugging-flags-1194">Debugging flags</a>: <a href="#Patching">Patching</a></li>
15557
<li><a href="#index-Debugging-optimized-code-608">Debugging optimized code</a>: <a href="#Compiling-for-Debugging">Compiling for Debugging</a></li>
15558
<li><a href="#index-Default-session-122">Default session</a>: <a href="#Resuming-Sessions">Resuming Sessions</a></li>
15559
<li><a href="#index-Deferred-display-902">Deferred display</a>: <a href="#Creating-Single-Displays">Creating Single Displays</a></li>
15560
<li><a href="#index-Deferred-display_002c-in-sessions-117">Deferred display, in sessions</a>: <a href="#Saving-Sessions">Saving Sessions</a></li>
15561
<li><a href="#index-Deleting-displays-973">Deleting displays</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15562
<li><a href="#index-Deleting-displays-474">Deleting displays</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15563
<li><a href="#index-Deleting-displays_002c-undoing-983">Deleting displays, undoing</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15564
<li><a href="#index-Dependent-display-900">Dependent display</a>: <a href="#Creating-Single-Displays">Creating Single Displays</a></li>
15565
<li><a href="#index-Dereferencing-1009">Dereferencing</a>: <a href="#Dereferencing-Pointers">Dereferencing Pointers</a></li>
15566
<li><a href="#index-Detail-toggling-with-_0040samp_007bShow_002fHide_007d-464">Detail toggling with ‘<samp><span class="samp">Show/Hide</span></samp>’</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15567
<li><a href="#index-Detail_002c-hiding-927">Detail, hiding</a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15568
<li><a href="#index-Detail_002c-showing-923">Detail, showing</a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15569
<li><a href="#index-Directory_002c-of-the-debugged-program-760">Directory, of the debugged program</a>: <a href="#Working-Directory">Working Directory</a></li>
15570
<li><a href="#index-Disabled-displays-933">Disabled displays</a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15571
<li><a href="#index-Disabling-displays_002c-undoing-938">Disabling displays, undoing</a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15572
<li><a href="#index-Display-888">Display</a>: <a href="#Displaying-Values">Displaying Values</a></li>
15573
<li><a href="#index-Display-Editor-971">Display Editor</a>: <a href="#Editing-all-Displays">Editing all Displays</a></li>
15574
<li><a href="#index-Display-name-906">Display name</a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15575
<li><a href="#index-Display-position-898">Display position</a>: <a href="#Creating-Single-Displays">Creating Single Displays</a></li>
15576
<li><a href="#index-Display-selection-913">Display selection</a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15577
<li><a href="#index-Display-title-904">Display title</a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15578
<li><a href="#index-Display-value-908">Display value</a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15579
<li><a href="#index-Display_002c-aligning-on-grid-1071">Display, aligning on grid</a>: <a href="#Aligning-Displays">Aligning Displays</a></li>
15580
<li><a href="#index-Display_002c-clustered-897">Display, clustered</a>: <a href="#Creating-Single-Displays">Creating Single Displays</a></li>
15581
<li><a href="#index-Display_002c-clustering-965">Display, clustering</a>: <a href="#Clustering">Clustering</a></li>
15582
<li><a href="#index-Display_002c-copying-987">Display, copying</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15583
<li><a href="#index-Display_002c-creating-892">Display, creating</a>: <a href="#Creating-Single-Displays">Creating Single Displays</a></li>
15584
<li><a href="#index-Display_002c-creating-457">Display, creating</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15585
<li><a href="#index-Display_002c-customizing-1031">Display, customizing</a>: <a href="#Customizing-Displays">Customizing Displays</a></li>
15586
<li><a href="#index-Display_002c-cutting-985">Display, cutting</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15587
<li><a href="#index-Display_002c-deferred-903">Display, deferred</a>: <a href="#Creating-Single-Displays">Creating Single Displays</a></li>
15588
<li><a href="#index-Display_002c-deleting-972">Display, deleting</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15589
<li><a href="#index-Display_002c-deleting-473">Display, deleting</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15590
<li><a href="#index-Display_002c-dependent-1008">Display, dependent</a>: <a href="#Dependent-Values">Dependent Values</a></li>
15591
<li><a href="#index-Display_002c-dependent-901">Display, dependent</a>: <a href="#Creating-Single-Displays">Creating Single Displays</a></li>
15592
<li><a href="#index-Display_002c-disabled-934">Display, disabled</a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15593
<li><a href="#index-Display_002c-frozen-731">Display, frozen</a>: <a href="#Stopping-X-Programs">Stopping X Programs</a></li>
15594
<li><a href="#index-Display_002c-hiding-details-926">Display, hiding details</a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15595
<li><a href="#index-Display_002c-locked-734">Display, locked</a>: <a href="#Stopping-X-Programs">Stopping X Programs</a></li>
15596
<li><a href="#index-Display_002c-moving-1063">Display, moving</a>: <a href="#Moving-Displays">Moving Displays</a></li>
15597
<li><a href="#index-Display_002c-pasting-989">Display, pasting</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15598
<li><a href="#index-Display_002c-placement-958">Display, placement</a>: <a href="#Placement">Placement</a></li>
15599
<li><a href="#index-Display_002c-plotting-the-history-1118">Display, plotting the history</a>: <a href="#Plotting-Histories">Plotting Histories</a></li>
15600
<li><a href="#index-Display_002c-refreshing-951">Display, refreshing</a>: <a href="#Refreshing-the-Data-Window">Refreshing the Data Window</a></li>
15601
<li><a href="#index-Display_002c-rotating-940">Display, rotating</a>: <a href="#Rotating-Displays">Rotating Displays</a></li>
15602
<li><a href="#index-Display_002c-rotating-466">Display, rotating</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15603
<li><a href="#index-Display_002c-selecting-910">Display, selecting</a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15604
<li><a href="#index-Display_002c-setting-469">Display, setting</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15605
<li><a href="#index-Display_002c-setting-135">Display, setting</a>: <a href="#Remote-Host">Remote Host</a></li>
15606
<li><a href="#index-Display_002c-setting-when-invoking-_0040DDD_007b_007d-80">Display, setting when invoking <acronym>DDD</acronym></a>: <a href="#X-Options">X Options</a></li>
15607
<li><a href="#index-Display_002c-showing-details-922">Display, showing details</a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15608
<li><a href="#index-Display_002c-suppressing-977">Display, suppressing</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15609
<li><a href="#index-Display_002c-toggling-detail-463">Display, toggling detail</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15610
<li><a href="#index-Display_002c-updating-952">Display, updating</a>: <a href="#Refreshing-the-Data-Window">Refreshing the Data Window</a></li>
15611
<li><a href="#index-Displaying-values-889">Displaying values</a>: <a href="#Displaying-Values">Displaying Values</a></li>
15612
<li><a href="#index-Displaying-values-869">Displaying values</a>: <a href="#Examining-Data">Examining Data</a></li>
15613
<li><a href="#index-Displaying-values-with-_0040samp_007bDisplay_007d-456">Displaying values with ‘<samp><span class="samp">Display</span></samp>’</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15614
<li><a href="#index-Dumping-values-873">Dumping values</a>: <a href="#Examining-Data">Examining Data</a></li>
15615
<li><a href="#index-Edge-1007">Edge</a>: <a href="#Dependent-Values">Dependent Values</a></li>
15616
<li><a href="#index-Edge-hint-1075">Edge hint</a>: <a href="#Automatic-Layout">Automatic Layout</a></li>
15617
<li><a href="#index-Edge-hint-1017">Edge hint</a>: <a href="#Shared-Structures">Shared Structures</a></li>
15618
<li><a href="#index-Editing-source-code-1167">Editing source code</a>: <a href="#Editing-Source-Code">Editing Source Code</a></li>
15619
<li><a href="#index-Emacs_002c-integrating-_0040DDD_007b_007d-1217">Emacs, integrating <acronym>DDD</acronym></a>: <a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">Integrating <acronym>DDD</acronym></a></li>
15620
<li><a href="#index-Emergency-repairs-1193">Emergency repairs</a>: <a href="#Patching">Patching</a></li>
15621
<li><a href="#index-Environment_002c-of-the-debugged-program-752">Environment, of the debugged program</a>: <a href="#Environment">Environment</a></li>
15622
<li><a href="#index-g_t_0040acronym_007bEPROM_007d-code-debugging-710"><acronym>EPROM</acronym> code debugging</a>: <a href="#Hardware_002dAssisted-Breakpoints">Hardware-Assisted Breakpoints</a></li>
15623
<li><a href="#index-Examining-memory-contents-1148">Examining memory contents</a>: <a href="#Examining-Memory">Examining Memory</a></li>
15624
<li><a href="#index-Execution-position_002c-dragging-812">Execution position, dragging</a>: <a href="#Continuing-Somewhere-Else">Continuing Somewhere Else</a></li>
15625
<li><a href="#index-Execution-window-771">Execution window</a>: <a href="#Using-the-Execution-Window">Using the Execution Window</a></li>
15626
<li><a href="#index-Execution-window-204">Execution window</a>: <a href="#Windows">Windows</a></li>
15627
<li><a href="#index-Execution_002c-_0060_0060undoing_0027_0027-836">Execution, “undoing”</a>: <a href="#Undoing-Program-Execution">Undoing Program Execution</a></li>
15628
<li><a href="#index-Execution_002c-aborting-318">Execution, aborting</a>: <a href="#Program-Menu">Program Menu</a></li>
15629
<li><a href="#index-Execution_002c-aborting-106">Execution, aborting</a>: <a href="#Quitting">Quitting</a></li>
15630
<li><a href="#index-Execution_002c-at-different-address-808">Execution, at different address</a>: <a href="#Continuing-Somewhere-Else">Continuing Somewhere Else</a></li>
15631
<li><a href="#index-Execution_002c-continuing-792">Execution, continuing</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15632
<li><a href="#index-Execution_002c-interrupting-102">Execution, interrupting</a>: <a href="#Quitting">Quitting</a></li>
15633
<li><a href="#index-Execution_002c-interrupting-automatically-193">Execution, interrupting automatically</a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15634
<li><a href="#index-Execution_002c-one-line-794">Execution, one line</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15635
<li><a href="#index-Execution_002c-to-location-800">Execution, to location</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15636
<li><a href="#index-Execution_002c-to-next-line-797">Execution, to next line</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15637
<li><a href="#index-Execution_002c-until-function-returns-805">Execution, until function returns</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15638
<li><a href="#index-Execution_002c-until-greater-line-is-reached-802">Execution, until greater line is reached</a>: <a href="#Resuming-Execution">Resuming Execution</a></li>
15639
<li><a href="#index-Exiting-97">Exiting</a>: <a href="#Quitting">Quitting</a></li>
15640
<li><a href="#index-Extending-display-selection-912">Extending display selection</a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15641
<li><a href="#index-FIG-file_002c-printing-as-1087">FIG file, printing as</a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15642
<li><a href="#index-Files_002c-opening-609">Files, opening</a>: <a href="#Opening-Files">Opening Files</a></li>
15643
<li><a href="#index-Finding-items-443">Finding items</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15644
<li><a href="#index-Fonts-586">Fonts</a>: <a href="#Customizing-Fonts">Customizing Fonts</a></li>
15645
<li><a href="#index-FORTRAN-11">FORTRAN</a>: <a href="#Summary">Summary</a></li>
15646
<li><a href="#index-Frame-817">Frame</a>: <a href="#Frames">Frames</a></li>
15647
<li><a href="#index-Frame-814">Frame</a>: <a href="#Stack">Stack</a></li>
15648
<li><a href="#index-Frame-changes_002c-undoing-835">Frame changes, undoing</a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
15649
<li><a href="#index-Frame-number-823">Frame number</a>: <a href="#Frames">Frames</a></li>
15650
<li><a href="#index-Frame-pointer-822">Frame pointer</a>: <a href="#Frames">Frames</a></li>
15651
<li><a href="#index-Frame_002c-selecting-824">Frame, selecting</a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
15652
<li><a href="#index-GCC-606">GCC</a>: <a href="#Compiling-for-Debugging">Compiling for Debugging</a></li>
15653
<li><a href="#index-g_t_0040acronym_007bGDB_007d-3"><acronym>GDB</acronym></a>: <a href="#Summary">Summary</a></li>
15654
<li><a href="#index-g_t_0040acronym_007bGDB_007d_002c-invoking-_0040DDD_007b_007d-with-59"><acronym>GDB</acronym>, invoking <acronym>DDD</acronym> with</a>: <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a></li>
15655
<li><a href="#index-Glyph-638">Glyph</a>: <a href="#Customizing-Glyphs">Customizing Glyphs</a></li>
15656
<li><a href="#index-GNU-Make-18">GNU Make</a>: <a href="#Summary">Summary</a></li>
15657
<li><a href="#index-GNU-Make_002c-invoking-_0040DDD_007b_007d-with-55">GNU Make, invoking <acronym>DDD</acronym> with</a>: <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a></li>
15658
<li><a href="#index-GPL-31">GPL</a>: <a href="#Free-Software">Free Software</a></li>
15659
<li><a href="#index-Grabbed-pointer-732">Grabbed pointer</a>: <a href="#Stopping-X-Programs">Stopping X Programs</a></li>
15660
<li><a href="#index-Graph_002c-printing-1081">Graph, printing</a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15661
<li><a href="#index-Graph_002c-rotating-1078">Graph, rotating</a>: <a href="#Rotating-the-Graph">Rotating the Graph</a></li>
15662
<li><a href="#index-Grid_002c-aligning-displays-1072">Grid, aligning displays</a>: <a href="#Aligning-Displays">Aligning Displays</a></li>
15663
<li><a href="#index-Grid_002c-in-plots-1107">Grid, in plots</a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
15664
<li><a href="#index-Help-1392">Help</a>: <a href="#Help-and-Assistance">Help and Assistance</a></li>
15665
<li><a href="#index-Help-506">Help</a>: <a href="#Getting-Help">Getting Help</a></li>
15666
<li><a href="#index-Help_002c-in-the-status-line-512">Help, in the status line</a>: <a href="#Getting-Help">Getting Help</a></li>
15667
<li><a href="#index-Help_002c-on-buttons-510">Help, on buttons</a>: <a href="#Getting-Help">Getting Help</a></li>
15668
<li><a href="#index-Help_002c-on-commands-518">Help, on commands</a>: <a href="#Getting-Help">Getting Help</a></li>
15669
<li><a href="#index-Help_002c-on-items-514">Help, on items</a>: <a href="#Getting-Help">Getting Help</a></li>
15670
<li><a href="#index-Help_002c-when-stuck-522">Help, when stuck</a>: <a href="#Getting-Help">Getting Help</a></li>
15671
<li><a href="#index-Hiding-display-details-928">Hiding display details</a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15672
<li><a href="#index-Historic-mode-838">Historic mode</a>: <a href="#Undoing-Program-Execution">Undoing Program Execution</a></li>
15673
<li><a href="#index-History-40">History</a>: <a href="#History">History</a></li>
15674
<li><a href="#index-History_002c-plotting-1120">History, plotting</a>: <a href="#Plotting-Histories">Plotting Histories</a></li>
15675
<li><a href="#index-Host_002c-remote-134">Host, remote</a>: <a href="#Remote-Host">Remote Host</a></li>
15676
<li><a href="#index-HTML-manual-26">HTML manual</a>: <a href="#About-this-Manual">About this Manual</a></li>
15677
<li><a href="#index-IBMGL-file_002c-printing-as-1088">IBMGL file, printing as</a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15678
<li><a href="#index-Icon_002c-invoking-_0040DDD_007b_007d-as-82">Icon, invoking <acronym>DDD</acronym> as</a>: <a href="#X-Options">X Options</a></li>
15679
<li><a href="#index-Ignore-count-695">Ignore count</a>: <a href="#Breakpoint-Ignore-Counts">Breakpoint Ignore Counts</a></li>
15680
<li><a href="#index-Indent_002c-source-code-649">Indent, source code</a>: <a href="#Customizing-Source-Appearance">Customizing Source Appearance</a></li>
15681
<li><a href="#index-Inferior-debugger-1">Inferior debugger</a>: <a href="#Summary">Summary</a></li>
15682
<li><a href="#index-Info-manual-22">Info manual</a>: <a href="#About-this-Manual">About this Manual</a></li>
15683
<li><a href="#index-Initial-frame-819">Initial frame</a>: <a href="#Frames">Frames</a></li>
15684
<li><a href="#index-Innermost-frame-821">Innermost frame</a>: <a href="#Frames">Frames</a></li>
15685
<li><a href="#index-Input-of-the-debugged-program-762">Input of the debugged program</a>: <a href="#Input_002fOutput">Input/Output</a></li>
15686
<li><a href="#index-Instruction_002c-stepping-1155">Instruction, stepping</a>: <a href="#Machine-Code-Execution">Machine Code Execution</a></li>
15687
<li><a href="#index-Integrating-_0040DDD_007b_007d-1216">Integrating <acronym>DDD</acronym></a>: <a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">Integrating <acronym>DDD</acronym></a></li>
15688
<li><a href="#index-Interrupting-_0040DDD_007b_007d-109">Interrupting <acronym>DDD</acronym></a>: <a href="#Quitting">Quitting</a></li>
15689
<li><a href="#index-Interrupting-execution-101">Interrupting execution</a>: <a href="#Quitting">Quitting</a></li>
15690
<li><a href="#index-Interrupting-execution_002c-automatically-192">Interrupting execution, automatically</a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15691
<li><a href="#index-Invoking-51">Invoking</a>: <a href="#Invoking">Invoking</a></li>
15692
<li><a href="#index-Java-16">Java</a>: <a href="#Summary">Summary</a></li>
15693
<li><a href="#index-g_t_0040acronym_007bJDB_007d-15"><acronym>JDB</acronym></a>: <a href="#Summary">Summary</a></li>
15694
<li><a href="#index-g_t_0040acronym_007bJDB_007d_002c-invoking-_0040DDD_007b_007d-with-54"><acronym>JDB</acronym>, invoking <acronym>DDD</acronym> with</a>: <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a></li>
15695
<li><a href="#index-Jump-to-different-address-810">Jump to different address</a>: <a href="#Continuing-Somewhere-Else">Continuing Somewhere Else</a></li>
15696
<li><a href="#index-Killing-_0040DDD_007b_007d-111">Killing <acronym>DDD</acronym></a>: <a href="#Quitting">Quitting</a></li>
15697
<li><a href="#index-Killing-the-debugged-program-863">Killing the debugged program</a>: <a href="#Killing-the-Program">Killing the Program</a></li>
15698
<li><a href="#index-Ladebug-13">Ladebug</a>: <a href="#Summary">Summary</a></li>
15699
<li><a href="#index-Ladebug_002c-invoking-_0040DDD_007b_007d-with-60">Ladebug, invoking <acronym>DDD</acronym> with</a>: <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a></li>
15700
<li><a href="#index-License-1390">License</a>: <a href="#License">License</a></li>
15701
<li><a href="#index-License-30">License</a>: <a href="#Free-Software">Free Software</a></li>
15702
<li><a href="#index-License_002c-Documentation-1394">License, Documentation</a>: <a href="#Documentation-License">Documentation License</a></li>
15703
<li><a href="#index-License_002c-showing-on-standard-output-72">License, showing on standard output</a>: <a href="#Options">Options</a></li>
15704
<li><a href="#index-Line-numbers-646">Line numbers</a>: <a href="#Customizing-Source-Appearance">Customizing Source Appearance</a></li>
15705
<li><a href="#index-Local-variables_002c-displaying-946">Local variables, displaying</a>: <a href="#Displaying-Local-Variables">Displaying Local Variables</a></li>
15706
<li><a href="#index-Logging-1359">Logging</a>: <a href="#Logging">Logging</a></li>
15707
<li><a href="#index-Logging_002c-disabling-1361">Logging, disabling</a>: <a href="#Disabling-Logging">Disabling Logging</a></li>
15708
<li><a href="#index-Looking-up-breakpoints-706">Looking up breakpoints</a>: <a href="#Looking-up-Breakpoints">Looking up Breakpoints</a></li>
15709
<li><a href="#index-Looking-up-items-441">Looking up items</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15710
<li><a href="#index-Lookups_002c-redoing-630">Lookups, redoing</a>: <a href="#Looking-up-Previous-Locations">Looking up Previous Locations</a></li>
15711
<li><a href="#index-Lookups_002c-undoing-629">Lookups, undoing</a>: <a href="#Looking-up-Previous-Locations">Looking up Previous Locations</a></li>
15712
<li><a href="#index-L_00fctkehaus_002c-Dorothea-43">L�tkehaus, Dorothea</a>: <a href="#History">History</a></li>
15713
<li><a href="#index-L_00fctkehaus_002c-Dorothea-37">L�tkehaus, Dorothea</a>: <a href="#Contributors">Contributors</a></li>
15714
<li><a href="#index-Machine-code-window-203">Machine code window</a>: <a href="#Windows">Windows</a></li>
15715
<li><a href="#index-Machine-code_002c-examining-1151">Machine code, examining</a>: <a href="#Machine-Code">Machine Code</a></li>
15716
<li><a href="#index-Machine-code_002c-executing-1152">Machine code, executing</a>: <a href="#Machine-Code-Execution">Machine Code Execution</a></li>
15717
<li><a href="#index-Mailing-list-1391">Mailing list</a>: <a href="#Help-and-Assistance">Help and Assistance</a></li>
15718
<li><a href="#index-Make_002c-invoking-1190">Make, invoking</a>: <a href="#Recompiling">Recompiling</a></li>
15719
<li><a href="#index-Manual_002c-showing-on-standard-output-73">Manual, showing on standard output</a>: <a href="#Options">Options</a></li>
15720
<li><a href="#index-Memory_002c-dumping-contents-875">Memory, dumping contents</a>: <a href="#Examining-Data">Examining Data</a></li>
15721
<li><a href="#index-Memory_002c-examining-1149">Memory, examining</a>: <a href="#Examining-Memory">Examining Memory</a></li>
15722
<li><a href="#index-Modula_002d2-6">Modula-2</a>: <a href="#Summary">Summary</a></li>
15723
<li><a href="#index-Modula_002d3-7">Modula-3</a>: <a href="#Summary">Summary</a></li>
15724
<li><a href="#index-Mouse-pointer_002c-frozen-730">Mouse pointer, frozen</a>: <a href="#Stopping-X-Programs">Stopping X Programs</a></li>
15725
<li><a href="#index-Name_002c-display-907">Name, display</a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15726
<li><a href="#index-News_002c-showing-on-standard-output-74">News, showing on standard output</a>: <a href="#Options">Options</a></li>
15727
<li><a href="#index-NORA-44">NORA</a>: <a href="#History">History</a></li>
15728
<li><a href="#index-Optimized-code_002c-debugging-607">Optimized code, debugging</a>: <a href="#Compiling-for-Debugging">Compiling for Debugging</a></li>
15729
<li><a href="#index-Option-52">Option</a>: <a href="#Invoking">Invoking</a></li>
15730
<li><a href="#index-Outermost-frame-820">Outermost frame</a>: <a href="#Frames">Frames</a></li>
15731
<li><a href="#index-Output-of-the-debugged-program-763">Output of the debugged program</a>: <a href="#Input_002fOutput">Input/Output</a></li>
15732
<li><a href="#index-Pascal-8">Pascal</a>: <a href="#Summary">Summary</a></li>
15733
<li><a href="#index-Pasting-displays-988">Pasting displays</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15734
<li><a href="#index-Patching-1191">Patching</a>: <a href="#Patching">Patching</a></li>
15735
<li><a href="#index-PDF-manual-25">PDF manual</a>: <a href="#About-this-Manual">About this Manual</a></li>
15736
<li><a href="#index-Perl-19">Perl</a>: <a href="#Summary">Summary</a></li>
15737
<li><a href="#index-Perl_002c-invoking-_0040DDD_007b_007d-with-56">Perl, invoking <acronym>DDD</acronym> with</a>: <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a></li>
15738
<li><a href="#index-PIC-file_002c-printing-as-1090">PIC file, printing as</a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15739
<li><a href="#index-Pipe-766">Pipe</a>: <a href="#Input_002fOutput">Input/Output</a></li>
15740
<li><a href="#index-Placement-959">Placement</a>: <a href="#Placement">Placement</a></li>
15741
<li><a href="#index-Plot-appearance-1104">Plot appearance</a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
15742
<li><a href="#index-Plot_002c-animating-1136">Plot, animating</a>: <a href="#Animating-Plots">Animating Plots</a></li>
15743
<li><a href="#index-Plot_002c-exporting-1133">Plot, exporting</a>: <a href="#Exporting-Plot-Data">Exporting Plot Data</a></li>
15744
<li><a href="#index-Plot_002c-printing-1121">Plot, printing</a>: <a href="#Printing-Plots">Printing Plots</a></li>
15745
<li><a href="#index-Plot_002c-scrolling-1115">Plot, scrolling</a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
15746
<li><a href="#index-Plotting-style-1110">Plotting style</a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
15747
<li><a href="#index-Plotting-values-1101">Plotting values</a>: <a href="#Plotting-Values">Plotting Values</a></li>
15748
<li><a href="#index-Plotting-values-871">Plotting values</a>: <a href="#Examining-Data">Examining Data</a></li>
15749
<li><a href="#index-Plotting-values-460">Plotting values</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15750
<li><a href="#index-Pointers_002c-dereferencing-1010">Pointers, dereferencing</a>: <a href="#Dereferencing-Pointers">Dereferencing Pointers</a></li>
15751
<li><a href="#index-Position_002c-of-display-899">Position, of display</a>: <a href="#Creating-Single-Displays">Creating Single Displays</a></li>
15752
<li><a href="#index-PostScript-manual-24">PostScript manual</a>: <a href="#About-this-Manual">About this Manual</a></li>
15753
<li><a href="#index-PostScript_002c-printing-as-1086">PostScript, printing as</a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15754
<li><a href="#index-Print_002c-output-formats-885">Print, output formats</a>: <a href="#Printing-Values">Printing Values</a></li>
15755
<li><a href="#index-Printing-plots-1122">Printing plots</a>: <a href="#Printing-Plots">Printing Plots</a></li>
15756
<li><a href="#index-Printing-the-Graph-1082">Printing the Graph</a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15757
<li><a href="#index-Printing-values-881">Printing values</a>: <a href="#Printing-Values">Printing Values</a></li>
15758
<li><a href="#index-Printing-values-867">Printing values</a>: <a href="#Examining-Data">Examining Data</a></li>
15759
<li><a href="#index-Printing-values-with-_0040samp_007bPrint_007d-453">Printing values with ‘<samp><span class="samp">Print</span></samp>’</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15760
<li><a href="#index-Process_002c-attaching-781">Process, attaching</a>: <a href="#Attaching-to-a-Process">Attaching to a Process</a></li>
15761
<li><a href="#index-Program-arguments-745">Program arguments</a>: <a href="#Starting-Program-Execution">Starting Program Execution</a></li>
15762
<li><a href="#index-Program-counter_002c-displaying-1158">Program counter, displaying</a>: <a href="#Machine-Code-Execution">Machine Code Execution</a></li>
15763
<li><a href="#index-Program-output_002c-confusing-767">Program output, confusing</a>: <a href="#Input_002fOutput">Input/Output</a></li>
15764
<li><a href="#index-Program_002c-on-remote-host-155">Program, on remote host</a>: <a href="#Remote-Program">Remote Program</a></li>
15765
<li><a href="#index-Program_002c-opening-610">Program, opening</a>: <a href="#Opening-Programs">Opening Programs</a></li>
15766
<li><a href="#index-Program_002c-patching-1192">Program, patching</a>: <a href="#Patching">Patching</a></li>
15767
<li><a href="#index-PSG-42">PSG</a>: <a href="#History">History</a></li>
15768
<li><a href="#index-pydb-21">pydb</a>: <a href="#Summary">Summary</a></li>
15769
<li><a href="#index-g_t_0040acronym_007bPYDB_007d_002c-invoking-_0040DDD_007b_007d-with-57"><acronym>PYDB</acronym>, invoking <acronym>DDD</acronym> with</a>: <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a></li>
15770
<li><a href="#index-Python-20">Python</a>: <a href="#Summary">Summary</a></li>
15771
<li><a href="#index-Quitting-98">Quitting</a>: <a href="#Quitting">Quitting</a></li>
15772
<li><a href="#index-Quotes-in-commands-1198">Quotes in commands</a>: <a href="#Command-Completion">Command Completion</a></li>
15773
<li><a href="#index-Readline-1215">Readline</a>: <a href="#TTY-mode">TTY mode</a></li>
15774
<li><a href="#index-Recompiling-1186">Recompiling</a>: <a href="#Recompiling">Recompiling</a></li>
15775
<li><a href="#index-Recording-commands-1240">Recording commands</a>: <a href="#GDB-Simple-Commands">GDB Simple Commands</a></li>
15776
<li><a href="#index-Redirecting-I_002fO-of-the-debugged-program-764">Redirecting I/O of the debugged program</a>: <a href="#Input_002fOutput">Input/Output</a></li>
15777
<li><a href="#index-Redirecting-I_002fO-to-the-execution-window-772">Redirecting I/O to the execution window</a>: <a href="#Using-the-Execution-Window">Using the Execution Window</a></li>
15778
<li><a href="#index-Redirection-765">Redirection</a>: <a href="#Input_002fOutput">Input/Output</a></li>
15779
<li><a href="#index-Redirection_002c-to-execution-window-774">Redirection, to execution window</a>: <a href="#Using-the-Execution-Window">Using the Execution Window</a></li>
15780
<li><a href="#index-Redirection_002c-to-execution-window-197">Redirection, to execution window</a>: <a href="#Debugger-Communication">Debugger Communication</a></li>
15781
<li><a href="#index-Redoing-commands-538">Redoing commands</a>: <a href="#Undo-and-Redo">Undo and Redo</a></li>
15782
<li><a href="#index-Redoing-lookups-628">Redoing lookups</a>: <a href="#Looking-up-Previous-Locations">Looking up Previous Locations</a></li>
15783
<li><a href="#index-Refreshing-displayed-values-953">Refreshing displayed values</a>: <a href="#Refreshing-the-Data-Window">Refreshing the Data Window</a></li>
15784
<li><a href="#index-Registers_002c-examining-1159">Registers, examining</a>: <a href="#Registers">Registers</a></li>
15785
<li><a href="#index-Reloading-source-code-1172">Reloading source code</a>: <a href="#Editing-Source-Code">Editing Source Code</a></li>
15786
<li><a href="#index-Remote-debugger-137">Remote debugger</a>: <a href="#Remote-Debugger">Remote Debugger</a></li>
15787
<li><a href="#index-Remote-host-133">Remote host</a>: <a href="#Remote-Host">Remote Host</a></li>
15788
<li><a href="#index-Remote-program-154">Remote program</a>: <a href="#Remote-Program">Remote Program</a></li>
15789
<li><a href="#index-Resource_002c-setting-when-invoking-_0040DDD_007b_007d-83">Resource, setting when invoking <acronym>DDD</acronym></a>: <a href="#X-Options">X Options</a></li>
15790
<li><a href="#index-Resources-539">Resources</a>: <a href="#Resources">Resources</a></li>
15791
<li><a href="#index-g_t_0040acronym_007bROM_007d-code-debugging-711"><acronym>ROM</acronym> code debugging</a>: <a href="#Hardware_002dAssisted-Breakpoints">Hardware-Assisted Breakpoints</a></li>
15792
<li><a href="#index-Rotating-displays-with-_0040samp_007bRotate_007d-467">Rotating displays with ‘<samp><span class="samp">Rotate</span></samp>’</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15793
<li><a href="#index-Rotating-the-graph-1079">Rotating the graph</a>: <a href="#Rotating-the-Graph">Rotating the Graph</a></li>
15794
<li><a href="#index-Running-the-debugged-program-743">Running the debugged program</a>: <a href="#Running">Running</a></li>
15795
<li><a href="#index-Scalars_002c-plotting-1116">Scalars, plotting</a>: <a href="#Scalars-and-Composites">Scalars and Composites</a></li>
15796
<li><a href="#index-Scales_002c-in-plots-1112">Scales, in plots</a>: <a href="#Plot-Appearance">Plot Appearance</a></li>
15797
<li><a href="#index-Scrolling-1068">Scrolling</a>: <a href="#Scrolling-Data">Scrolling Data</a></li>
15798
<li><a href="#index-Search_002c-using-_0040samp_007bFind-_003e_003e_007d-444">Search, using ‘<samp><span class="samp">Find >></span></samp>’</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15799
<li><a href="#index-Searching-commands-1204">Searching commands</a>: <a href="#Command-History">Command History</a></li>
15800
<li><a href="#index-Selecting-frames-825">Selecting frames</a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
15801
<li><a href="#index-Selecting-multiple-displays-919">Selecting multiple displays</a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15802
<li><a href="#index-Selecting-single-displays-911">Selecting single displays</a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15803
<li><a href="#index-Session-112">Session</a>: <a href="#Sessions">Sessions</a></li>
15804
<li><a href="#index-Session_002c-active-118">Session, active</a>: <a href="#Saving-Sessions">Saving Sessions</a></li>
15805
<li><a href="#index-Session_002c-default-123">Session, default</a>: <a href="#Resuming-Sessions">Resuming Sessions</a></li>
15806
<li><a href="#index-Session_002c-deleting-126">Session, deleting</a>: <a href="#Deleting-Sessions">Deleting Sessions</a></li>
15807
<li><a href="#index-Session_002c-opening-119">Session, opening</a>: <a href="#Resuming-Sessions">Resuming Sessions</a></li>
15808
<li><a href="#index-Session_002c-resuming-120">Session, resuming</a>: <a href="#Resuming-Sessions">Resuming Sessions</a></li>
15809
<li><a href="#index-Session_002c-saving-113">Session, saving</a>: <a href="#Saving-Sessions">Saving Sessions</a></li>
15810
<li><a href="#index-Session_002c-setting-when-invoking-_0040DDD_007b_007d-76">Session, setting when invoking <acronym>DDD</acronym></a>: <a href="#Options">Options</a></li>
15811
<li><a href="#index-Setting-variables-1003">Setting variables</a>: <a href="#Assignment">Assignment</a></li>
15812
<li><a href="#index-Setting-variables-with-_0040samp_007bSet_007d-470">Setting variables with ‘<samp><span class="samp">Set</span></samp>’</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15813
<li><a href="#index-Shared-structures_002c-detecting-1016">Shared structures, detecting</a>: <a href="#Shared-Structures">Shared Structures</a></li>
15814
<li><a href="#index-Showing-display-details-924">Showing display details</a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15815
<li><a href="#index-SIGABRT-signal-319">SIGABRT signal</a>: <a href="#Program-Menu">Program Menu</a></li>
15816
<li><a href="#index-SIGABRT-signal-107">SIGABRT signal</a>: <a href="#Quitting">Quitting</a></li>
15817
<li><a href="#index-SIGALRM-signal-847">SIGALRM signal</a>: <a href="#Signals">Signals</a></li>
15818
<li><a href="#index-SIGINT-signal-845">SIGINT signal</a>: <a href="#Signals">Signals</a></li>
15819
<li><a href="#index-SIGINT-signal-727">SIGINT signal</a>: <a href="#Interrupting">Interrupting</a></li>
15820
<li><a href="#index-Signal-settings_002c-editing-849">Signal settings, editing</a>: <a href="#Signals">Signals</a></li>
15821
<li><a href="#index-Signal-settings_002c-saving-862">Signal settings, saving</a>: <a href="#Signals">Signals</a></li>
15822
<li><a href="#index-Signal_002c-fatal-848">Signal, fatal</a>: <a href="#Signals">Signals</a></li>
15823
<li><a href="#index-Signal_002c-sending-to-_0040DDD_007b_007d-110">Signal, sending to <acronym>DDD</acronym></a>: <a href="#Quitting">Quitting</a></li>
15824
<li><a href="#index-Signals-844">Signals</a>: <a href="#Signals">Signals</a></li>
15825
<li><a href="#index-SIGSEGV-signal-846">SIGSEGV signal</a>: <a href="#Signals">Signals</a></li>
15826
<li><a href="#index-SIGTRAP-signal-855">SIGTRAP signal</a>: <a href="#Signals">Signals</a></li>
15827
<li><a href="#index-SIGUSR1-signal-1364">SIGUSR1 signal</a>: <a href="#Debugging-_003cacronym_003eDDD_003c_002facronym_003e">Debugging <acronym>DDD</acronym></a></li>
15828
<li><a href="#index-SIGUSR1-signal-399">SIGUSR1 signal</a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
15829
<li><a href="#index-Source-code_002c-editing-1168">Source code, editing</a>: <a href="#Editing-Source-Code">Editing Source Code</a></li>
15830
<li><a href="#index-Source-code_002c-recompiling-1187">Source code, recompiling</a>: <a href="#Recompiling">Recompiling</a></li>
15831
<li><a href="#index-Source-code_002c-reloading-1173">Source code, reloading</a>: <a href="#Editing-Source-Code">Editing Source Code</a></li>
15832
<li><a href="#index-Source-directory-632">Source directory</a>: <a href="#Source-Path">Source Path</a></li>
15833
<li><a href="#index-Source-file_002c-opening-618">Source file, opening</a>: <a href="#Opening-Source-Files">Opening Source Files</a></li>
15834
<li><a href="#index-Source-file_002c-typing-into-1212">Source file, typing into</a>: <a href="#Typing-in-the-Source-Window">Typing in the Source Window</a></li>
15835
<li><a href="#index-Source-path-633">Source path</a>: <a href="#Source-Path">Source Path</a></li>
15836
<li><a href="#index-Source-path_002c-specifying-635">Source path, specifying</a>: <a href="#Source-Path">Source Path</a></li>
15837
<li><a href="#index-Source-window-200">Source window</a>: <a href="#Windows">Windows</a></li>
15838
<li><a href="#index-Source_002c-accessing-631">Source, accessing</a>: <a href="#Source-Path">Source Path</a></li>
15839
<li><a href="#index-Stack-Frame-818">Stack Frame</a>: <a href="#Frames">Frames</a></li>
15840
<li><a href="#index-Stack-frame-815">Stack frame</a>: <a href="#Stack">Stack</a></li>
15841
<li><a href="#index-Stack_002c-moving-within-826">Stack, moving within</a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
15842
<li><a href="#index-Status-display-949">Status display</a>: <a href="#Displaying-Program-Status">Displaying Program Status</a></li>
15843
<li><a href="#index-Status-line-513">Status line</a>: <a href="#Getting-Help">Getting Help</a></li>
15844
<li><a href="#index-Status-line_002c-location-584">Status line, location</a>: <a href="#Window-Layout">Window Layout</a></li>
15845
<li><a href="#index-Suppressing-values-978">Suppressing values</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15846
<li><a href="#index-Tab-width-654">Tab width</a>: <a href="#Customizing-Source-Appearance">Customizing Source Appearance</a></li>
15847
<li><a href="#index-g_t_0040TeX_007b_007d-file_002c-printing-as-1089">TeX file, printing as</a>: <a href="#Printing-the-Graph">Printing the Graph</a></li>
15848
<li><a href="#index-g_t_0040TeX_007b_007dinfo-manual-28">TeXinfo manual</a>: <a href="#About-this-Manual">About this Manual</a></li>
15849
<li><a href="#index-Theme_002c-Data-1032">Theme, Data</a>: <a href="#Using-Data-Themes">Using Data Themes</a></li>
15850
<li><a href="#index-Theme_002c-editing-1047">Theme, editing</a>: <a href="#Editing-Themes">Editing Themes</a></li>
15851
<li><a href="#index-Theme_002c-for-suppressing-values-975">Theme, for suppressing values</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15852
<li><a href="#index-Threads-842">Threads</a>: <a href="#Threads">Threads</a></li>
15853
<li><a href="#index-Tic-Tac-Toe-game-401">Tic Tac Toe game</a>: <a href="#Maintenance-Menu">Maintenance Menu</a></li>
15854
<li><a href="#index-Tip-of-the-day-534">Tip of the day</a>: <a href="#Getting-Help">Getting Help</a></li>
15855
<li><a href="#index-Tip-of-the-day_002c-turning-off-550">Tip of the day, turning off</a>: <a href="#Tip-of-the-day">Tip of the day</a></li>
15856
<li><a href="#index-Tip_002c-on-buttons-511">Tip, on buttons</a>: <a href="#Getting-Help">Getting Help</a></li>
15857
<li><a href="#index-Tip_002c-value-877">Tip, value</a>: <a href="#Value-Tips">Value Tips</a></li>
15858
<li><a href="#index-Tip_002c-value-866">Tip, value</a>: <a href="#Examining-Data">Examining Data</a></li>
15859
<li><a href="#index-Title_002c-display-905">Title, display</a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15860
<li><a href="#index-Tool-Bar_002c-location-581">Tool Bar, location</a>: <a href="#Window-Layout">Window Layout</a></li>
15861
<li><a href="#index-Tool-tip-508">Tool tip</a>: <a href="#Getting-Help">Getting Help</a></li>
15862
<li><a href="#index-Tornado-1388">Tornado</a>: <a href="#WindRiver-GDB">WindRiver GDB</a></li>
15863
<li><a href="#index-g_t_0040acronym_007bTTY_007d-interface-1214"><acronym>TTY</acronym> interface</a>: <a href="#TTY-mode">TTY mode</a></li>
15864
<li><a href="#index-g_t_0040acronym_007bTTY_007d-mode_002c-setting-when-invoking-_0040DDD_007b_007d-79"><acronym>TTY</acronym> mode, setting when invoking <acronym>DDD</acronym></a>: <a href="#Options">Options</a></li>
15865
<li><a href="#index-g_t_0040acronym_007bTTY_007d-settings-768"><acronym>TTY</acronym> settings</a>: <a href="#Input_002fOutput">Input/Output</a></li>
15866
<li><a href="#index-Undo-deleting-displays-982">Undo deleting displays</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15867
<li><a href="#index-Undo-disabling-displays-937">Undo disabling displays</a>: <a href="#Showing-and-Hiding-Details">Showing and Hiding Details</a></li>
15868
<li><a href="#index-Undoing-commands-536">Undoing commands</a>: <a href="#Undo-and-Redo">Undo and Redo</a></li>
15869
<li><a href="#index-Undoing-frame-changes-834">Undoing frame changes</a>: <a href="#Selecting-a-frame">Selecting a frame</a></li>
15870
<li><a href="#index-Undoing-lookups-627">Undoing lookups</a>: <a href="#Looking-up-Previous-Locations">Looking up Previous Locations</a></li>
15871
<li><a href="#index-Undoing-program-execution-837">Undoing program execution</a>: <a href="#Undoing-Program-Execution">Undoing Program Execution</a></li>
15872
<li><a href="#index-Undoing-signal-handling-857">Undoing signal handling</a>: <a href="#Signals">Signals</a></li>
15873
<li><a href="#index-Updating-displayed-values-954">Updating displayed values</a>: <a href="#Refreshing-the-Data-Window">Refreshing the Data Window</a></li>
15874
<li><a href="#index-User_002ddefined-command-1236">User-defined command</a>: <a href="#Defining-Commands">Defining Commands</a></li>
15875
<li><a href="#index-Value-tip-876">Value tip</a>: <a href="#Value-Tips">Value Tips</a></li>
15876
<li><a href="#index-Value-tip-865">Value tip</a>: <a href="#Examining-Data">Examining Data</a></li>
15877
<li><a href="#index-Value_002c-display-909">Value, display</a>: <a href="#Selecting-Displays">Selecting Displays</a></li>
15878
<li><a href="#index-Value_002c-displaying-887">Value, displaying</a>: <a href="#Displaying-Values">Displaying Values</a></li>
15879
<li><a href="#index-Value_002c-displaying-870">Value, displaying</a>: <a href="#Examining-Data">Examining Data</a></li>
15880
<li><a href="#index-Value_002c-dumping-874">Value, dumping</a>: <a href="#Examining-Data">Examining Data</a></li>
15881
<li><a href="#index-Value_002c-plotting-872">Value, plotting</a>: <a href="#Examining-Data">Examining Data</a></li>
15882
<li><a href="#index-Value_002c-plotting-the-history-1119">Value, plotting the history</a>: <a href="#Plotting-Histories">Plotting Histories</a></li>
15883
<li><a href="#index-Value_002c-printing-882">Value, printing</a>: <a href="#Printing-Values">Printing Values</a></li>
15884
<li><a href="#index-Value_002c-printing-868">Value, printing</a>: <a href="#Examining-Data">Examining Data</a></li>
15885
<li><a href="#index-Values_002c-displaying-with-_0040samp_007bDisplay_007d-455">Values, displaying with ‘<samp><span class="samp">Display</span></samp>’</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15886
<li><a href="#index-Values_002c-plotting-1100">Values, plotting</a>: <a href="#Plotting-Values">Plotting Values</a></li>
15887
<li><a href="#index-Values_002c-plotting-with-_0040samp_007bPlot_007d-459">Values, plotting with ‘<samp><span class="samp">Plot</span></samp>’</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15888
<li><a href="#index-Values_002c-printing-with-_0040samp_007bPrint_007d-452">Values, printing with ‘<samp><span class="samp">Print</span></samp>’</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15889
<li><a href="#index-Values_002c-suppressing-976">Values, suppressing</a>: <a href="#Deleting-Displays">Deleting Displays</a></li>
15890
<li><a href="#index-Variables_002c-setting-1004">Variables, setting</a>: <a href="#Assignment">Assignment</a></li>
15891
<li><a href="#index-Variables_002c-setting-with-_0040samp_007bSet_007d-471">Variables, setting with ‘<samp><span class="samp">Set</span></samp>’</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15892
<li><a href="#index-virtual-machine-86">virtual machine</a>: <a href="#JDB-Options">JDB Options</a></li>
15893
<li><a href="#index-VM-85">VM</a>: <a href="#JDB-Options">JDB Options</a></li>
15894
<li><a href="#index-VSL-46">VSL</a>: <a href="#History">History</a></li>
15895
<li><a href="#index-Watchpoint-713">Watchpoint</a>: <a href="#Watchpoints">Watchpoints</a></li>
15896
<li><a href="#index-Watchpoint-665">Watchpoint</a>: <a href="#Stopping">Stopping</a></li>
15897
<li><a href="#index-Watchpoint-properties-717">Watchpoint properties</a>: <a href="#Editing-Watchpoint-Properties">Editing Watchpoint Properties</a></li>
15898
<li><a href="#index-Watchpoint_002c-deleting-723">Watchpoint, deleting</a>: <a href="#Deleting-Watchpoints">Deleting Watchpoints</a></li>
15899
<li><a href="#index-Watchpoint_002c-editing-718">Watchpoint, editing</a>: <a href="#Editing-Watchpoint-Properties">Editing Watchpoint Properties</a></li>
15900
<li><a href="#index-Watchpoint_002c-setting-715">Watchpoint, setting</a>: <a href="#Setting-Watchpoints">Setting Watchpoints</a></li>
15901
<li><a href="#index-Watchpoint_002c-toggling-448">Watchpoint, toggling</a>: <a href="#Tool-Bar">Tool Bar</a></li>
15902
<li><a href="#index-Watchpoints_002c-editing-721">Watchpoints, editing</a>: <a href="#Editing-all-Watchpoints">Editing all Watchpoints</a></li>
15903
<li><a href="#index-WDB-1384">WDB</a>: <a href="#WDB">WDB</a></li>
15904
<li><a href="#index-g_t_0040acronym_007bWDB_007d_002c-invoking-_0040DDD_007b_007d-with-1386"><acronym>WDB</acronym>, invoking <acronym>DDD</acronym> with</a>: <a href="#WDB">WDB</a></li>
15905
<li><a href="#index-g_t_0040acronym_007bWDB_007d_002c-invoking-_0040DDD_007b_007d-with-61"><acronym>WDB</acronym>, invoking <acronym>DDD</acronym> with</a>: <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a></li>
15906
<li><a href="#index-WildeBeest-1385">WildeBeest</a>: <a href="#WDB">WDB</a></li>
15907
<li><a href="#index-WindRiver-GDB-1387">WindRiver GDB</a>: <a href="#WindRiver-GDB">WindRiver GDB</a></li>
15908
<li><a href="#index-Working-directory_002c-of-the-debugged-program-759">Working directory, of the debugged program</a>: <a href="#Working-Directory">Working Directory</a></li>
15909
<li><a href="#index-X-programs_002c-stopping-728">X programs, stopping</a>: <a href="#Stopping-X-Programs">Stopping X Programs</a></li>
15910
<li><a href="#index-X-server_002c-frozen-729">X server, frozen</a>: <a href="#Stopping-X-Programs">Stopping X Programs</a></li>
15911
<li><a href="#index-X-server_002c-locked-733">X server, locked</a>: <a href="#Stopping-X-Programs">Stopping X Programs</a></li>
15912
<li><a href="#index-X-session-125">X session</a>: <a href="#Resuming-Sessions">Resuming Sessions</a></li>
15913
<li><a href="#index-X-Warnings_002c-suppressing-91">X Warnings, suppressing</a>: <a href="#X-Warnings">X Warnings</a></li>
15914
<li><a href="#index-g_t_0040acronym_007bXDB_007d-14"><acronym>XDB</acronym></a>: <a href="#Summary">Summary</a></li>
15915
<li><a href="#index-g_t_0040acronym_007bXDB_007d_002c-invoking-_0040DDD_007b_007d-with-62"><acronym>XDB</acronym>, invoking <acronym>DDD</acronym> with</a>: <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a></li>
15916
<li><a href="#index-XEmacs_002c-integrating-_0040DDD_007b_007d-1219">XEmacs, integrating <acronym>DDD</acronym></a>: <a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">Integrating <acronym>DDD</acronym></a></li>
15917
<li><a href="#index-g_t_0040acronym_007bXXGDB_007d_002c-integrating-_0040DDD_007b_007d-1222"><acronym>XXGDB</acronym>, integrating <acronym>DDD</acronym></a>: <a href="#Integrating-_003cacronym_003eDDD_003c_002facronym_003e">Integrating <acronym>DDD</acronym></a></li>
15918
<li><a href="#index-Zeller_002c-Andreas-41">Zeller, Andreas</a>: <a href="#History">History</a></li>
15919
<li><a href="#index-Zeller_002c-Andreas-36">Zeller, Andreas</a>: <a href="#Contributors">Contributors</a></li>
15920
</ul><div class="footnote">
18009
15921
<hr>
18010
<h4>Footnotes</h4>
18011
<ol type="1">
18012
<li><a name="fn-1"></a>
18013
<p>Within <small>DDD</small> (and
18014
this manual), Ladebug is considered a <small>DBX</small> variant. Hence, everything
18015
said for <small>DBX</small> also applies to Ladebug, unless stated otherwise.</p>
18016
18017
<li><a name="fn-2"></a>
18018
<p><small>XDB</small> will no longer be maintained in future <small>DDD</small>
18019
releases. Use a recent <small>GDB</small> version instead.</p>
18020
18021
<li><a name="fn-3"></a>
18022
<p>Actual numbers and behavior on your system may
15922
<a name="texinfo-footnotes-in-document"></a><h4>Footnotes</h4><p class="footnote"><small>[<a name="fn-1" href="#fnd-1">1</a>]</small> Within <acronym>DDD</acronym> (and
15923
this manual), Ladebug is considered a <acronym>DBX</acronym> variant. Hence, everything
15924
said for <acronym>DBX</acronym> also applies to Ladebug, unless stated otherwise.</p>
15925
15926
<p class="footnote"><small>[<a name="fn-2" href="#fnd-2">2</a>]</small> <acronym>XDB</acronym> will no longer be maintained in future <acronym>DDD</acronym>
15927
releases. Use a recent <acronym>GDB</acronym> version instead.</p>
15928
15929
<p class="footnote"><small>[<a name="fn-3" href="#fnd-3">3</a>]</small> Actual numbers and behavior on your system may
18023
15930
vary.</p>
18024
15931
18025
<li><a name="fn-4"></a>
18026
<p>Re-invoke <small>DDD</small> with
18027
<code>--gdb</code>, if you do not see a <code>(gdb)</code> prompt here
18028
(see <a href="#Choosing%20an%20Inferior%20Debugger">Choosing an Inferior Debugger</a>)</p>
15932
<p class="footnote"><small>[<a name="fn-4" href="#fnd-4">4</a>]</small> Re-invoke <acronym>DDD</acronym> with
15933
<samp><span class="option">--gdb</span></samp>, if you do not see a ‘<samp><span class="samp">(gdb)</span></samp>’ prompt here
15934
(see <a href="#Choosing-an-Inferior-Debugger">Choosing an Inferior Debugger</a>)</p>
18029
15935
18030
<li><a name="fn-5"></a>
18031
<p>Only if a
15936
<p class="footnote"><small>[<a name="fn-5" href="#fnd-5">5</a>]</small> Only if a
18032
15937
core file is included.</p>
18033
15938
18034
<li><a name="fn-6"></a>
18035
<p>If a core file is
18036
<em>not</em> to be included in the session, <small>DDD</small> data displays are
15939
<p class="footnote"><small>[<a name="fn-6" href="#fnd-6">6</a>]</small> If a core file is
15940
<em>not</em> to be included in the session, <acronym>DDD</acronym> data displays are
18037
15941
saved as <em>deferred</em>; that is, they will be restored as soon as
18038
15942
program execution reaches the scope in which they were created.
18039
See <a href="#Creating%20Single%20Displays">Creating Single Displays</a>, for details.</p>
18040
18041
<li><a name="fn-7"></a>
18042
<p>Requires X11R6 or later.</p>
18043
18044
<li><a name="fn-8"></a>
18045
<p>If
18046
you use a <code>Ddd</code> application-defaults file, you will not be
18047
able to maintain multiple <small>DDD</small> versions at the same time. This
18048
is why the suiting <code>Ddd</code> is normally compiled into the
18049
<small>DDD</small> executable.</p>
18050
18051
<li><a name="fn-9"></a>
18052
<p>If you use <small>DDD</small> to
15943
See <a href="#Creating-Single-Displays">Creating Single Displays</a>, for details.</p>
15944
15945
<p class="footnote"><small>[<a name="fn-7" href="#fnd-7">7</a>]</small> Requires X11R6 or later.</p>
15946
15947
<p class="footnote"><small>[<a name="fn-8" href="#fnd-8">8</a>]</small> If
15948
you use a <samp><span class="file">Ddd</span></samp> application-defaults file, you will not be
15949
able to maintain multiple <acronym>DDD</acronym> versions at the same time. This
15950
is why the suiting <samp><span class="file">Ddd</span></samp> is normally compiled into the
15951
<acronym>DDD</acronym> executable.</p>
15952
15953
<p class="footnote"><small>[<a name="fn-9" href="#fnd-9">9</a>]</small> If you use <acronym>DDD</acronym> to
18053
15954
debug Perl, Python or Bash scripts, then this section does not apply.</p>
18054
15955
18055
<li><a name="fn-10"></a>
18056
<p>With <small>XDB</small> and some <small>DBX</small> variants, the debugged program
15956
<p class="footnote"><small>[<a name="fn-10" href="#fnd-10">10</a>]</small> With <acronym>XDB</acronym> and some <acronym>DBX</acronym> variants, the debugged program
18057
15957
must be specified upon invocation and cannot be changed at run time.</p>
18058
15958
18059
<li><a name="fn-11"></a>
18060
<p><small>JDB</small>,
18061
<small>PYDB</small>, Perl, and Bash do not support core dumps.</p>
15959
<p class="footnote"><small>[<a name="fn-11" href="#fnd-11">11</a>]</small> <acronym>JDB</acronym>,
15960
<code>pydb</code>, Perl, and Bash do not support core dumps.</p>
18062
15961
18063
<li><a name="fn-12"></a>
18064
<p><small>JDB</small> does not support
15962
<p class="footnote"><small>[<a name="fn-12" href="#fnd-12">12</a>]</small> <acronym>JDB</acronym> does not support
18065
15963
breakpoint disabling.</p>
18066
15964
18067
<li><a name="fn-13"></a>
18068
<p><small>JDB</small> does not support temporary breakpoints.</p>
15965
<p class="footnote"><small>[<a name="fn-13" href="#fnd-13">13</a>]</small> <acronym>JDB</acronym> does not support temporary breakpoints.</p>
18069
15966
18070
<li><a name="fn-14"></a>
18071
<p><small>GDB</small> has
15967
<p class="footnote"><small>[<a name="fn-14" href="#fnd-14">14</a>]</small> <acronym>GDB</acronym> has
18072
15968
no way to make a temporary breakpoint non-temporary again.</p>
18073
15969
18074
<li><a name="fn-15"></a>
18075
<p><small>JDB</small>, Perl
18076
and some <small>DBX</small> variants do not support breakpoint ignore counts.</p>
15970
<p class="footnote"><small>[<a name="fn-15" href="#fnd-15">15</a>]</small> <acronym>JDB</acronym>, Perl
15971
and some <acronym>DBX</acronym> variants do not support breakpoint ignore counts.</p>
18077
15972
18078
<li><a name="fn-16"></a>
18079
<p><small>JDB</small>, <small>PYDB</small>, and some <small>DBX</small> variants do
15973
<p class="footnote"><small>[<a name="fn-16" href="#fnd-16">16</a>]</small> <acronym>JDB</acronym>, <code>pydb</code>, and some <acronym>DBX</acronym> variants do
18080
15974
not support breakpoint commands.</p>
18081
15975
18082
<li><a name="fn-17"></a>
18083
<p>When
18084
glyphs are disabled (see <a href="#Customizing%20Source">Customizing Source</a>), breakpoints cannot be
15976
<p class="footnote"><small>[<a name="fn-17" href="#fnd-17">17</a>]</small> When
15977
glyphs are disabled (see <a href="#Customizing-Source">Customizing Source</a>), breakpoints cannot be
18085
15978
dragged. Delete and set breakpoints instead.</p>
18086
15979
18087
<li><a name="fn-18"></a>
18088
<p>Watchpoints are available in <small>GDB</small> and
18089
some <small>DBX</small> variants only. In <small>XDB</small>, a similar feature is available via <small>XDB</small>
18090
<dfn>assertions</dfn>; see the <small>XDB</small> documentation for details.</p>
15980
<p class="footnote"><small>[<a name="fn-18" href="#fnd-18">18</a>]</small> Watchpoints are available in <acronym>GDB</acronym> and
15981
some <acronym>DBX</acronym> variants only. In <acronym>XDB</acronym>, a similar feature is available via <acronym>XDB</acronym>
15982
<dfn>assertions</dfn>; see the <acronym>XDB</acronym> documentation for details.</p>
18091
15983
18092
<li><a name="fn-19"></a>
18093
<p>If <Ctrl+C> is not bound to
18094
<code>Copy</code> (see <a href="#Customizing%20the%20Edit%20Menu">Customizing the Edit Menu</a>), you can also use
15984
<p class="footnote"><small>[<a name="fn-19" href="#fnd-19">19</a>]</small> If <Ctrl+C> is not bound to
15985
‘<samp><span class="samp">Copy</span></samp>’ (see <a href="#Customizing-the-Edit-Menu">Customizing the Edit Menu</a>), you can also use
18095
15986
<Ctrl+C> to interrupt the running program.</p>
18096
15987
18097
<li><a name="fn-20"></a>
18098
<p>If the debuggee runs in a separate
18099
execution window, the debuggee's <code>TERM</code> value is set according to
18100
the <code>termType</code> resource; See <a href="#Customizing%20the%20Execution%20Window">Customizing the Execution Window</a>,
15988
<p class="footnote"><small>[<a name="fn-20" href="#fnd-20">20</a>]</small> If the debuggee runs in a separate
15989
execution window, the debuggee's <samp><span class="env">TERM</span></samp> value is set according to
15990
the ‘<samp><span class="samp">termType</span></samp>’ resource; See <a href="#Customizing-the-Execution-Window">Customizing the Execution Window</a>,
18101
15991
for details.</p>
18102
15992
18103
<li><a name="fn-21"></a>
18104
<p>The execution window is not available in <small>JDB</small>.</p>
15993
<p class="footnote"><small>[<a name="fn-21" href="#fnd-21">21</a>]</small> The execution window is not available in <acronym>JDB</acronym>.</p>
18105
15994
18106
<li><a name="fn-22"></a>
18107
<p><small>JDB</small>, <small>PYDB</small>, Perl, and Bash do not support
15995
<p class="footnote"><small>[<a name="fn-22" href="#fnd-22">22</a>]</small> <acronym>JDB</acronym>, <code>pydb</code>, Perl, and Bash do not support
18108
15996
attaching the debugger to running processes.</p>
18109
15997
18110
<li><a name="fn-23"></a>
18111
<p><small>JDB</small>, <small>PYDB</small>, Perl, and Bash do not support
15998
<p class="footnote"><small>[<a name="fn-23" href="#fnd-23">23</a>]</small> <acronym>JDB</acronym>, <code>pydb</code>, Perl, and Bash do not support
18112
15999
altering the execution position.</p>
18113
16000
18114
<li><a name="fn-24"></a>
18115
<p>When glyphs are
18116
disabled (see <a href="#Customizing%20Source">Customizing Source</a>), dragging the execution position
16001
<p class="footnote"><small>[<a name="fn-24" href="#fnd-24">24</a>]</small> When glyphs are
16002
disabled (see <a href="#Customizing-Source">Customizing Source</a>), dragging the execution position
18117
16003
is not possible. Set the execution position explicitly instead.</p>
18118
16004
18119
<li><a name="fn-25"></a>
18120
<p>Perl does not allow
16005
<p class="footnote"><small>[<a name="fn-25" href="#fnd-25">25</a>]</small> Perl does not allow
18121
16006
changing the current stack frame.</p>
18122
16007
18123
<li><a name="fn-26"></a>
18124
<p>Currently, threads are supported in <small>GDB</small> and <small>JDB</small> only.</p>
16008
<p class="footnote"><small>[<a name="fn-26" href="#fnd-26">26</a>]</small> Currently, threads are supported in <acronym>GDB</acronym> and <acronym>JDB</acronym> only.</p>
18125
16009
18126
<li><a name="fn-27"></a>
18127
<p>This
16010
<p class="footnote"><small>[<a name="fn-27" href="#fnd-27">27</a>]</small> This
18128
16011
requires that the full array size is known to the debugger.</p>
18129
16012
18130
<li><a name="fn-28"></a>
18131
<p><small>JDB</small> 1.1 does not support changing variable values.</p>
18132
18133
<li><a name="fn-29"></a>
18134
<p>The string <code>//</code>; can
18135
be changed via the <code>labelDelimiter</code> resource. See <a href="#Customizing%20Buttons">Customizing Buttons</a>, for details.</p>
18136
18137
<li><a name="fn-30"></a>
18138
<p>The machine code window is available with <small>GDB</small> and
18139
some <small>DBX</small> variants only.</p>
18140
18141
<li><a name="fn-31"></a>
18142
<p>The machine code
18143
window is available with <small>GDB</small> and some <small>DBX</small> variants only.</p>
18144
18145
<li><a name="fn-32"></a>
18146
<p>If you use <small>DDD</small> commands
16013
<p class="footnote"><small>[<a name="fn-28" href="#fnd-28">28</a>]</small> <acronym>JDB</acronym> 1.1 does not support changing variable values.</p>
16014
16015
<p class="footnote"><small>[<a name="fn-29" href="#fnd-29">29</a>]</small> The string ‘<samp><span class="samp">//</span></samp>’; can
16016
be changed via the ‘<samp><span class="samp">labelDelimiter</span></samp>’ resource. See <a href="#Customizing-Buttons">Customizing Buttons</a>, for details.</p>
16017
16018
<p class="footnote"><small>[<a name="fn-30" href="#fnd-30">30</a>]</small> The machine code window is available with <acronym>GDB</acronym> and
16019
some <acronym>DBX</acronym> variants only.</p>
16020
16021
<p class="footnote"><small>[<a name="fn-31" href="#fnd-31">31</a>]</small> The machine code
16022
window is available with <acronym>GDB</acronym> and some <acronym>DBX</acronym> variants only.</p>
16023
16024
<p class="footnote"><small>[<a name="fn-32" href="#fnd-32">32</a>]</small> If you use <acronym>DDD</acronym> commands
18147
16025
within command definitions, or if you include debugger commands that
18148
16026
resume execution, these commands will be realized transparently as
18149
<dfn>auto-commands</dfn>--that is, they won't be executed directly by the
16027
<dfn>auto-commands</dfn>—that is, they won't be executed directly by the
18150
16028
inferior debugger, but result in a command string being sent to
18151
<small>DDD</small>. This command string is then interpreted by <small>DDD</small> and
16029
<acronym>DDD</acronym>. This command string is then interpreted by <acronym>DDD</acronym> and
18152
16030
sent back to the inferior debugger, possibly prefixed by some other
18153
commands such that <small>DDD</small> can update its state. See <a href="#Commands%20with%20Other%20Debuggers">Commands with Other Debuggers</a>, for a discussion.</p>
16031
commands such that <acronym>DDD</acronym> can update its state. See <a href="#Commands-with-Other-Debuggers">Commands with Other Debuggers</a>, for a discussion.</p>
18154
16032
18155
<li><a name="fn-33"></a>
18156
<p>Since the inferior
18157
debugger is invoked through a virtual <small>TTY</small>, standard error is
18158
normally redirected to standard output, so <small>DDD</small> never receives
16033
<p class="footnote"><small>[<a name="fn-33" href="#fnd-33">33</a>]</small> Since the inferior
16034
debugger is invoked through a virtual <acronym>TTY</acronym>, standard error is
16035
normally redirected to standard output, so <acronym>DDD</acronym> never receives
18159
16036
standard error from the inferior debugger.</p>
18160
16037
18161
<li><a name="fn-34"></a>
18162
<p>This section
16038
<p class="footnote"><small>[<a name="fn-34" href="#fnd-34">34</a>]</small> This section
18163
16039
was contributed by Gary Cliff from Computing Devices Canada
18164
16040
Ltd., <a href="mailto:gary.cliff@cdott.com">gary.cliff@cdott.com</a>.</p>
18165
16041
18166
</ol><hr></div>
18167
18168
</body></html>
18169
16042
<hr></div>
16043
16044
</body></html>
16045
16046
<!--
16047
16048
Local Variables:
16049
coding: iso-8859-1
16050
End:
16051
16052
-->
Loggerhead is a web-based interface for Breezy
Version: 2.0.1