source: vendor/emx/current/src/pmgdb/pmgdb.ipp

Last change on this file was 18, checked in by bird, 23 years ago

Initial revision
  • Property cvs2svn:cvs-rev set to 1.1
  • Property svn:eol-style set to native
  • Property svn:executable set to *
File size: 75.6 KB
Line 
1.* pmgdb.ipp
2.*
3.* Copyright (c) 1996 Eberhard Mattes
4.*
5.* This file is part of pmgdb.
6.*
7.* pmgdb is free software; you can redistribute it and/or modify it
8.* under the terms of the GNU General Public License as published by
9.* the Free Software Foundation; either version 2, or (at your option)
10.* any later version.
11.*
12.* pmgdb is distributed in the hope that it will be useful,
13.* but WITHOUT ANY WARRANTY; without even the implied warranty of
14.* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15.* GNU General Public License for more details.
16.*
17.* You should have received a copy of the GNU General Public License
18.* along with pmgdb; see the file COPYING. If not, write to the
19.* the Free Software Foundation, 59 Temple Place - Suite 330,
20.* Boston, MA 02111-1307, USA.
21.*
22:userdoc.
23:prolog.
24:docprof toc=1234.
25:title.Help for pmgdb
26:eprolog.
27:body.
28
29.imd help.h
30
31.nameit symbol=tt text=':font facename=Courier size=16x9.'
32.nameit symbol=ett text=':font facename=default size=0x0.'
33
34.************************************************************************
35.* General help, nothing selected
36.************************************************************************
37:h1 res=&HELP_GENERAL..About pmgdb
38:i1 id='pmgdb'.pmgdb
39:lm margin=1.
40:p.
41:hp2.pmgdb:ehp2. is a Presentation Manager frontend for GDB, the
42GNU debugger.
43:p.
44To start :hp2.pmgdb:ehp2. from the command line, type
45:lm margin=5.:xmp.pmgdb app.exe arg1 arg2:exmp.:lm margin=1.
46:p.
47where &tt.app.exe&ett. is the application
48to be debugged and &tt.arg1&ett. and &tt.arg2&ett. are command
49line arguments for that application.
50:p.
51Alternatively, you can select the application to debug and provide
52command line arguments with :hp2.pmgdb:ehp2.'s menus.
53:p.
54In addition to a :link reftype=hd res=&HELP_TUTORIAL..tutorial:elink.,
55help is available on the following topics&colon.
56:p.
57:ul.
58:li.:link reftype=hd res=&HELP_CMD_WINDOW..The command window:elink.
59:li.:link reftype=hd res=&HELP_SRC_WINDOW..Source windows:elink.
60:li.:link reftype=hd res=&HELP_SRCS_WINDOW..Source files window:elink.
61:li.:link reftype=hd res=&HELP_BRK_WINDOW..Breakpoints window:elink.
62:li.:link reftype=hd res=&HELP_DSP_WINDOW..Display window:elink.
63:li.:link reftype=hd res=&HELP_THR_WINDOW..Threads window:elink.
64:li.:link reftype=hd res=&HELP_REG_WINDOW..Register window:elink.
65:eul.
66
67.************************************************************************
68.* Command window
69.************************************************************************
70:h1 res=&HELP_CMD_WINDOW..Help for command window
71:i1 id='cmd'.pmgdb command window
72:lm margin=1.
73:p.
74The command window of :hp2.pmgdb:ehp2. shows GDB's output. You can
75type GDB commands in the command window. Select
76:link reftype=hd res=&HPM_CMD_HISTORY..History:elink. from the
77:link reftype=hd res=&HPM_CMD_FILEMENU..File:elink. menu to
78edit the command. If you close the command
79window, :hp2.pmgdb:ehp2. will be terminated.
80:p.
81In addition to a :link reftype=hd res=&HELP_TUTORIAL..tutorial:elink.,
82help is available on the following topics&colon.
83:p.
84:ul.
85:li.:link reftype=hd res=&HPM_CMD_FILEMENU..File menu:elink.
86:li.:link reftype=hd res=&HPM_CMD_EDITMENU..Edit menu:elink.
87:li.:link reftype=hd res=&HPM_CMD_RUNMENU..Run menu:elink.
88:li.:link reftype=hd res=&HPM_CMD_BRKPTMENU..Breakpoints menu:elink.
89:li.:link reftype=hd res=&HPM_CMD_OPTIONSMENU..Options menu:elink.
90:li.:link reftype=hd res=&HPM_CMD_WINMENU..Windows menu:elink.
91:li.:link reftype=hd res=&HPM_CMD_HELPMENU..Help menu:elink.
92:li.:link reftype=hd res=&HELP_CMD_KEYS..Keys in the command window:elink.
93:eul.
94
95.************************************************************************
96.* File
97.************************************************************************
98:h2 res=&HPM_CMD_FILEMENU..Help for File
99:i2 refid='cmd'.File menu
100:i1 id='cmd.file'.File menu choices (command window)
101:lm margin=1.
102:p.
103The File menu contains the following choices&colon.
104:parml compact.
105:pt.:link reftype=hd res=&HPM_CMD_OPEN_EXEC..Open program file:elink.
106:pd.Open a program file.
107:pt.:link reftype=hd res=&HPM_CMD_OPEN_CORE..Open core file:elink.
108:pd.Open a core dump file.
109:pt.:link reftype=hd res=&HPM_OPEN_SOURCE..Open a source file:elink.
110:pd.Open a source file.
111:pt.:link reftype=hd res=&HPM_CMD_STARTUP..Startup:elink.
112:pd.Set command line arguments and other startup options.
113:pt.:link reftype=hd res=&HPM_RESTART..Restart:elink.
114:pd.Restart the program.
115:pt.:link reftype=hd res=&HPM_WHERE..Where:elink.
116:pd.Show current location of execution.
117:pt.:link reftype=hd res=&HPM_EXIT..Exit:elink.
118:pd.Terminate :hp2.pmgdb:ehp2..
119:eparml.
120
121.************************************************************************
122.* Open program file
123.************************************************************************
124:h3 res=&HPM_CMD_OPEN_EXEC..Help for Open program file
125:i2 refid='cmd.file'.Open program file
126:i2 refid='pmgdb'.Open program file
127:i2 refid='pmgdb'.Program file
128:lm margin=1.
129:p.
130Use this choice to open a program file, that is, to specify the program
131to be debugged (debuggee).
132
133.************************************************************************
134.* Open core file
135.************************************************************************
136:h3 res=&HPM_CMD_OPEN_CORE..Help for Open core file
137:i2 refid='cmd.file'.Open core file
138:i2 refid='pmgdb'.Open core file
139:i2 refid='pmgdb'.core file
140:lm margin=1.
141:p.
142Use this choice to open a core dump file.
143
144.************************************************************************
145.* Open source file
146.************************************************************************
147:h3 res=&HPM_OPEN_SOURCE..Help for Open source file
148:i2 refid='cmd.file'.Open source file
149:i2 refid='pmgdb'.Open source file
150:i2 refid='pmgdb'.Source file
151:lm margin=1.
152:p.
153Use this choice to open a source file. If the source file is already
154loaded, the window for that source file will be displayed. Otherwise,
155the source file will be loaded and displayed in a new window.
156
157.************************************************************************
158.* Startup
159.************************************************************************
160:h3 res=&HPM_CMD_STARTUP..Help for Startup
161:i2 refid='cmd.file'.Startup
162:i2 refid='pmgdb'.Startup
163:i2 refid='pmgdb'.Command line arguments for debuggee
164:lm margin=1.
165:p.
166Use this choice to specify startup options.
167This choice opens the
168:link reftype=hd res=&HPD_STARTUP..Startup:elink. dialog box.
169You can enter the command line options and select whether the
170VIO window of the debuggee should be closed after termination of the
171debuggee.
172
173.************************************************************************
174.* Restart
175.************************************************************************
176:h3 res=&HPM_RESTART..Help for Restart
177:i2 refid='cmd.file'.Restart
178:i2 refid='pmgdb'.Restart
179:lm margin=1.
180:p.
181Use this choice to restart the debuggee. If the debuggee is running,
182it will be stopped and restarted. If the debuggee is not running, it
183will be started. The debugger keeps any breakpoints. If no
184breakpoints are set (or all breakpoints are disabled), a breakpoint
185will be set on &tt.main&ett.
186
187.************************************************************************
188.* Where
189.************************************************************************
190:h3 res=&HPM_WHERE..Help for Where
191:i2 refid='cmd.file'.Where
192:i2 refid='pmgdb'.Where
193:lm margin=1.
194:p.
195Use this choice to show the current location of execution. If source
196code is available for that location, the appropriate source file will
197be displayed with the current line highlighted.
198
199.************************************************************************
200.* Exit
201.************************************************************************
202:h3 res=&HPM_EXIT..Help for Exit
203:i2 refid='cmd.file'.Exit
204:i2 refid='pmgdb'.Exit
205:lm margin=1.
206:p.
207Use this choice to terminate :hp2.pmgdb:ehp2.. If a debuggee is running,
208it will be terminated. :hp2.GDB:ehp2. will also be terminated.
209
210.************************************************************************
211.* Edit
212.************************************************************************
213:h2 res=&HPM_CMD_EDITMENU..Help for Edit
214:i2 refid='cmd'.Edit menu
215:i1 id='cmd.edit'.Edit menu choices (command window)
216:lm margin=1.
217:p.
218The Edit menu contains the following choices&colon.
219:parml compact.
220:pt.:link reftype=hd res=&HPM_CMD_COMPLETE..Complete:elink.
221:pd.Command completion.
222:pt.:link reftype=hd res=&HPM_CMD_HISTORY..History:elink.
223:pd.Select, edit, and repeat a previously issued command.
224:eparml.
225
226.************************************************************************
227.* Complete
228.************************************************************************
229:h3 res=&HPM_CMD_COMPLETE..Help for Complete
230:i2 refid='cmd.edit'.Complete
231:i2 refid='pmgdb'.Complete
232:lm margin=1.
233:p.
234Use this choice to complete the command typed in the command window.
235If there is more than one possible completion, a popup window will
236show all available completions. Select one of those choices to
237complete the command.
238
239.************************************************************************
240.* History
241.************************************************************************
242:h3 res=&HPM_CMD_HISTORY..Help for History
243:i2 refid='cmd.edit'.History
244:i2 refid='pmgdb'.History
245:lm margin=1.
246:p.
247Use this choice to select and edit a command from a list of all previously
248issued commands or to edit the current command. This choice opens the
249:link reftype=hd res=&HPD_HISTORY..History:elink. dialog box.
250
251.************************************************************************
252.* Run
253.************************************************************************
254:h2 res=&HPM_CMD_RUNMENU..Help for Run
255:i2 refid='pmgdb'.Run menu (command window)
256:i1 id='cmd.run'.Run menu choices
257:lm margin=1.
258:p.
259The Run menu contains the following choices&colon.
260:parml compact.
261:pt.:link reftype=hd res=&HPM_GO..Go:elink.
262:pd.Continue (or start) program.
263:pt.:link reftype=hd res=&HPM_STEPOVER..Step over:elink.
264:pd.Step program, proceeding through subroutine calls.
265:pt.:link reftype=hd res=&HPM_STEPINTO..Step into:elink.
266:pd.Step program until it reaches a different source line.
267:pt.:link reftype=hd res=&HPM_FINISH..Finish:elink.
268:pd.Execute until selected stack frame returns.
269:pt.:link reftype=hd res=&HPM_ISTEPOVER..Insn step over:elink.
270:pd.Step one instruction, proceeding through subroutine calls.
271:pt.:link reftype=hd res=&HPM_ISTEPINTO..Insn step into:elink.
272:pd.Step one instruction.
273:eparml.
274
275.************************************************************************
276.* Go
277.************************************************************************
278:h3 res=&HPM_GO..Help for Go
279:i2 refid='cmd.run'.Go
280:i2 refid='pmgdb'.Go
281:i2 refid='pmgdb'.Continue program
282:i2 refid='pmgdb'.Start program
283:lm margin=1.
284:p.
285Use this choice to let the program run until a breakpoint is hit or a
286signal occurs. If the program has not yet been started, it will be
287started and a breakpoint will be set on &tt.main&ett. if no
288breakpoints are set (or all breakpoints are disabled).
289
290.************************************************************************
291.* Step over
292.************************************************************************
293:h3 res=&HPM_STEPOVER..Help for Step over
294:i2 refid='cmd.run'.Step over
295:i2 refid='pmgdb'.Step over
296:lm margin=1.
297:p.
298Use this choice to step the program, proceeding through subroutine calls.
299Subroutine calls are treated as one instruction. If there are no subroutine
300calls, this choice is equivalent to
301:link reftype=hd res=&HPM_STEPINTO..Step into:elink..
302
303.************************************************************************
304.* Step into
305.************************************************************************
306:h3 res=&HPM_STEPINTO..Help for Step into
307:i2 refid='cmd.run'.Step into
308:i2 refid='pmgdb'.Step into
309:lm margin=1.
310:p.
311Use this choice to step the program until it reaches a different source
312line. See also
313:link reftype=hd res=&HPM_STEPOVER..Step over:elink..
314
315.************************************************************************
316.* Finish
317.************************************************************************
318:h3 res=&HPM_FINISH..Help for Finish
319:i2 refid='cmd.run'.Finish
320:i2 refid='pmgdb'.Finish
321:lm margin=1.
322:p.
323Use this choice to execute the program until the selected stack frame
324returns. That is, this choice finishes a subroutine call, stopping
325at the location from which the subroutine was called. The returned value
326is printed in the command window.
327
328.************************************************************************
329.* Insn step over
330.************************************************************************
331:h3 res=&HPM_ISTEPOVER..Help for Insn step over
332:i2 refid='cmd.run'.Insn step over
333:i2 refid='pmgdb'.Insn step over
334:lm margin=1.
335:p.
336Use this choice to step one instruction of the program. Subroutine
337calls are treated as one instruction. If the instruction is not
338a subroutine call, this choice is equivalent to
339:link reftype=hd res=&HPM_ISTEPINTO..Insn step into:elink..
340
341.************************************************************************
342.* Insn step into
343.************************************************************************
344:h3 res=&HPM_ISTEPINTO..Help for Insn step into
345:i2 refid='cmd.run'.Insn step into
346:i2 refid='pmgdb'.Insn step into
347:lm margin=1.
348:p.
349Use this choice to step one instruction of the program. See also
350:link reftype=hd res=&HPM_ISTEPOVER..Insn step over:elink..
351
352.************************************************************************
353.* Breakpoints
354.************************************************************************
355:h2 res=&HPM_CMD_BRKPTMENU..Help for Breakpoints
356:i2 refid='cmd'.Breakpoints menu
357:i1 id='cmd.brkpt'.Breakpoints menu choices (command window)
358:lm margin=1.
359:p.
360The Breakpoints menu contains the following choices&colon.
361:parml compact.
362:pt.:link reftype=hd res=&HPM_BRKPT_LINE..On line:elink.
363:pd.Set a breakpoint on a line.
364:pt.:link reftype=hd res=&HPM_BRKPT_LIST..List:elink.
365:pd.Open the breakpoints window.
366:eparml.
367
368.************************************************************************
369.* On line
370.************************************************************************
371:h3 res=&HPM_BRKPT_LINE..Help for On line
372:i2 refid='cmd.brkpt'.On line
373:i2 refid='pmgdb'.On line
374:i2 refid='pmgdb'.Breakpoint, on line
375:lm margin=1.
376:p.
377Use this choice to set a breakpoint on a line of the source code.
378This choice opens the
379:link reftype=hd res=&HPD_BRKPT_LINE..Line Breakpoint:elink. dialog box.
380:p.
381You can also set or clear a breakpoint by double clicking with the
382first mouse button on the line number in a source window.
383
384.************************************************************************
385.* List
386.************************************************************************
387:h3 res=&HPM_BRKPT_LIST..Help for List
388:i2 refid='cmd.brkpt'.List
389:i2 refid='pmgdb'.List
390:i2 refid='pmgdb'.Breakpoint, list
391:lm margin=1.
392:p.
393Use this choice to open the breakpoints window which shows all the
394breakpoints.
395
396.************************************************************************
397.* Options
398.************************************************************************
399:h2 res=&HPM_CMD_OPTIONSMENU..Help for Options
400:i2 refid='cmd'.Options menu
401:i1 id='cmd.options'.Options menu choices
402:lm margin=1.
403:p.
404The Options menu contains the following choices&colon.
405:parml compact.
406:pt.:link reftype=hd res=&HPM_PMDEBUGMODE..PM debugging mode:elink.
407:pd.Select the mode for debugging PM applications.
408:pt.:link reftype=hd res=&HPM_CMD_ANNOTATE..Annotate:elink.
409:pd.Print annotations.
410:pt.:link reftype=hd res=&HPM_CMD_FONT..Font:elink.
411:pd.Select font.
412:eparml.
413
414.************************************************************************
415.* PM debugging mode
416.************************************************************************
417:h3 res=&HPM_PMDEBUGMODE..Help for PM debugging mode
418:i2 refid='cmd.options'.PM debugging mode
419:i2 refid='pmgdb'.PM debugging mode
420:lm margin=1.
421:p.
422Use this choice to select the mode for debugging PM applications.
423Synchronous mode should be selected before starting a Presentation
424Manager application, otherwise the Presentation Manager will hang,
425requiring a reboot to recover. In Synchronous mode, only windows of
426:hp2.pmgdb:ehp2. and of the program being debugged can be made active;
427all other windows cannot be used.
428:hp2.pmgdb:ehp2. attempts to set Synchronous mode automatically when
429a PM program is loaded. This choice opens the
430:link reftype=hd res=&HPD_PMDEBUGMODE..PM debugging mode:elink. dialog box.
431
432.************************************************************************
433.* Annotate
434.************************************************************************
435:h3 res=&HPM_CMD_ANNOTATE..Help for Annotate
436:i2 refid='cmd.options'.Annotate
437:i2 refid='pmgdb'.Annotate
438:lm margin=1.
439:p.
440Use this choice to turn on printing of GDB's annotations. This us
441used for debugging :hp2.pmgdb:ehp2..
442
443.************************************************************************
444.* Font
445.************************************************************************
446:h3 res=&HPM_CMD_FONT..Help for Font
447:i2 refid='cmd.options'.Font
448:i2 refid='pmgdb'.Font
449:lm margin=1.
450:p.
451Use this choice to select a font for all windows of :hp2.pmgdb:ehp2..
452You can change the font of a single window by dragging a font from the
453Font Palette and dropping it on a :hp2.pmgdb:ehp2. window.
454
455.************************************************************************
456.* Windows
457.************************************************************************
458:h2 res=&HPM_CMD_WINMENU..Help for Windows
459:i2 refid='cmd'.Windows menu
460:i1 id='cmd.win'.Windows menu choices
461:lm margin=1.
462:p.
463The Windows menu contains the following choices&colon.
464:parml compact.
465:pt.:link reftype=hd res=&HPM_WIN_SRCS..Source files:elink.
466:pd.Show the source files window.
467:pt.:link reftype=hd res=&HPM_WIN_BRK..Breakpoints:elink.
468:pd.Show the breakpoints window.
469:pt.:link reftype=hd res=&HPM_WIN_DSP..Display:elink.
470:pd.Show the display window.
471:pt.:link reftype=hd res=&HPM_WIN_THR..Threads:elink.
472:pd.Show the threads window.
473:pt.:link reftype=hd res=&HPM_WIN_REG..Register:elink.
474:pd.Show the register window.
475:eparml.
476
477.************************************************************************
478.* Source files
479.************************************************************************
480:h3 res=&HPM_WIN_SRCS..Help for Source files
481:i2 refid='cmd.win'.Source files
482:i2 refid='pmgdb'.Source files
483:lm margin=1.
484:p.
485Use this choice to show the source files window.
486
487.************************************************************************
488.* Breakpoints
489.************************************************************************
490:h3 res=&HPM_WIN_BRK..Help for Breakpoints
491:i2 refid='cmd.win'.Breakpoints
492:i2 refid='pmgdb'.Breakpoints
493:lm margin=1.
494:p.
495Use this choice to show the breakpoints window.
496
497.************************************************************************
498.* Display
499.************************************************************************
500:h3 res=&HPM_WIN_DSP..Help for Display
501:i2 refid='cmd.win'.Display
502:i2 refid='pmgdb'.Display
503:lm margin=1.
504:p.
505Use this choice to show the display window.
506
507.************************************************************************
508.* Threads
509.************************************************************************
510:h3 res=&HPM_WIN_THR..Help for Threads
511:i2 refid='cmd.win'.Threads
512:i2 refid='pmgdb'.Threads
513:lm margin=1.
514:p.
515Use this choice to show the threads window.
516
517.************************************************************************
518.* Register
519.************************************************************************
520:h3 res=&HPM_WIN_REG..Help for Register
521:i2 refid='cmd.win'.Register
522:i2 refid='pmgdb'.Register
523:lm margin=1.
524:p.
525Use this choice to show the register window.
526
527.************************************************************************
528.* Help
529.************************************************************************
530:h2 res=&HPM_CMD_HELPMENU..Help for Help
531:i2 refid='cmd'.Help menu
532:i1 id='cmd.help'.Help menu choices
533:lm margin=1.
534:p.
535The Help menu contains the following choices&colon.
536:parml compact.
537:pt.:link reftype=hd res=&HPM_HELP_HELP..Help for help:elink.
538:pd.Display help for help.
539:pt.:link reftype=hd res=&HPM_HELP_EXT..Extended help:elink.
540:pd.Display extended help.
541:pt.:link reftype=hd res=&HPM_HELP_KEYS..Keys help:elink.
542:pd.Display help about keys.
543:pt.:link reftype=hd res=&HPM_HELP_INDEX..Help index:elink.
544:pd.Display the help index.
545:pt.:link reftype=hd res=&HPM_HELP_CONTENTS..Help index:elink.
546:pd.Display the help contents.
547:pt.:link reftype=hd res=&HPM_TUTORIAL..Tutorial:elink.
548:pd.Display tutorial.
549:pt.:link reftype=hd res=&HPM_CMD_ABOUT..About:elink.
550:pd.Display copyright information.
551:eparml.
552
553.************************************************************************
554.* Help for Help
555.************************************************************************
556:h3 res=&HPM_HELP_HELP..Help for Help
557:i2 refid='cmd.help'.Help for Help
558:lm margin=1.
559:p.
560Use this choice to get online help for help.
561
562.************************************************************************
563.* Extended help
564.************************************************************************
565:h3 res=&HPM_HELP_EXT..Help for Extended help
566:i2 refid='cmd.help'.Extended help
567:lm margin=1.
568:p.
569Use this choice to get online help
570for :hp2.pmgdb:ehp2.. You can also press the :hp2.F1:ehp2. key
571to get online help.
572
573.************************************************************************
574.* Keys help
575.************************************************************************
576:h3 res=&HPM_HELP_KEYS..Help for Keys help
577:i2 refid='cmd.help'.Keys help
578:lm margin=1.
579:p.
580Use this choice to get online help for :hp2.pmgdb:ehp2. keys.
581
582.************************************************************************
583.* Help index
584.************************************************************************
585:h3 res=&HPM_HELP_INDEX..Help for Help index
586:i2 refid='cmd.help'.Help for Help index
587:lm margin=1.
588:p.
589Use this choice to display the help index.
590
591.************************************************************************
592.* Help contents
593.************************************************************************
594:h3 res=&HPM_HELP_CONTENTS..Help for Help contents
595:i2 refid='cmd.help'.Help for Help contents
596:lm margin=1.
597:p.
598Use this choice to display the table of contents for online help.
599
600.************************************************************************
601.* Tutorial
602.************************************************************************
603:h3 res=&HPM_TUTORIAL..Help for Tutorial
604:i2 refid='cmd.help'.Tutorial
605:lm margin=1.
606:p.
607Use this choice to display the :hp2.pmgdb:ehp2.
608:link reftype=hd res=&HELP_TUTORIAL..tutorial:elink..
609
610.************************************************************************
611.* About
612.************************************************************************
613:h3 res=&HPM_CMD_ABOUT..Help for About
614:i2 refid='cmd.help'.About
615:i2 refid='pmgdb'.Author
616:i2 refid='pmgdb'.Copyright
617:lm margin=1.
618:p.
619Use this choice to display copyright information
620about :hp2.pmgdb:ehp2..
621
622.************************************************************************
623.* Keys help (command window)
624.************************************************************************
625:h1 res=&HELP_CMD_KEYS..Keys help (command window)
626:i1 id='cmd.keys'.Keys (command window)
627:lm margin=1.
628:p.
629You can use the following keys in the command window&colon.
630:dl tsize=20 compact.
631:dt.Backspace:dd.Delete one character to the left.
632:dt.Up arrow:dd.Fetch the previous command from the command history.
633:dt.Down arrow:dd.Fetch the next command from the command history.
634:dt.Page Up:dd.Scroll down by one window.
635:dt.Page Down:dd.Scroll up by one window.
636:dt.Ctrl+Page Up:dd.Scroll down right by one window.
637:dt.Ctrl+Page Down:dd.Scroll left by one window.
638:edl.
639:p.
640Accelerator keys are missed out in the list above.
641
642.************************************************************************
643.* Source window
644.************************************************************************
645:h1 res=&HELP_SRC_WINDOW..Help for source window
646:i1 id='src'.pmgdb source window
647:lm margin=1.
648:p.
649The source windows of :hp2.pmgdb:ehp2. show the source code of the
650application being debugged. There may be multiple source windows,
651one for each source file. Closing a source window doesn't terminate
652:hp2.pmgdb:ehp2..
653:p.
654Help is available on the following topics&colon.
655:p.
656:ul.
657:li.:link reftype=hd res=&HPM_SRC_FILEMENU..File menu:elink.
658:li.:link reftype=hd res=&HPM_SRC_VIEWMENU..View menu:elink.
659:li.:link reftype=hd res=&HPM_SRC_RUNMENU..Run menu:elink.
660:li.:link reftype=hd res=&HPM_SRC_BRKPTMENU..Breakpoints menu:elink.
661:li.:link reftype=hd res=&HPM_SRC_DSPMENU..Display menu:elink.
662:li.:link reftype=hd res=&HPM_SRC_OPTIONSMENU..Options menu:elink.
663:li.:link reftype=hd res=&HPM_SRC_WINMENU..Windows menu:elink.
664:li.:link reftype=hd res=&HPM_SRC_HELPMENU..Help menu:elink.
665:li.:link reftype=hd res=&HELP_SRC_KEYS..Keys in a source window:elink.
666:eul.
667
668.************************************************************************
669.* File
670.************************************************************************
671:h2 res=&HPM_SRC_FILEMENU..Help for File
672:i2 refid='src'.File menu
673:i1 id='src.file'.File menu choices (source window)
674:lm margin=1.
675:p.
676The File menu contains the following choices&colon.
677:parml compact.
678:pt.:link reftype=hd res=&HPM_OPEN_SOURCE..Open a source file:elink.
679:pd.Open a source file.
680:pt.:link reftype=hd res=&HPM_RESTART..Restart:elink.
681:pd.Restart the program.
682:pt.:link reftype=hd res=&HPM_WHERE..Where:elink.
683:pd.Show current location of execution.
684:pt.:link reftype=hd res=&HPM_EXIT..Exit:elink.
685:pd.Terminate :hp2.pmgdb:ehp2..
686:eparml.
687
688.************************************************************************
689.* View
690.************************************************************************
691:h2 res=&HPM_SRC_VIEWMENU..Help for View
692:i2 refid='src'.View menu
693:i1 id='src.view'.View menu choices (source window)
694:lm margin=1.
695:p.
696The View menu contains the following choices&colon.
697:parml compact.
698:pt.:link reftype=hd res=&HPM_SRC_FIND..Find:elink.
699:pd.Search for a regular expression.
700:pt.:link reftype=hd res=&HPM_SRC_FINDNEXT..Find next:elink.
701:pd.Search for next occurrence.
702:pt.:link reftype=hd res=&HPM_SRC_FINDPREV..Find previous:elink.
703:pd.Search for previous occurrence.
704:pt.:link reftype=hd res=&HPM_SRC_GOTO..Go to line:elink.
705:pd.Show a line specified by line number.
706:eparml.
707
708.************************************************************************
709.* Find
710.************************************************************************
711:h3 res=&HPM_SRC_FIND..Help for Find
712:i2 refid='src.view'.Find
713:i2 refid='pmgdb'.Find
714:lm margin=1.
715:p.
716Use this choice to search the source file for a regular expression.
717This choice opens the
718:link reftype=hd res=&HPD_FIND..Find:elink. dialog box.
719The search starts at the beginning of the file.
720See also :link reftype=hd res=&HPM_SRC_FINDNEXT..Find next:elink.
721and :link reftype=hd res=&HPM_SRC_FINDPREV..Find previous:elink..
722
723.************************************************************************
724.* Find next
725.************************************************************************
726:h3 res=&HPM_SRC_FINDNEXT..Help for Find next
727:i2 refid='src.view'.Find next
728:i2 refid='pmgdb'.Find next
729:lm margin=1.
730:p.
731Use this choice to search for the next occurrence of a regular expression.
732The search continues from the line following the line containing the
733previously found match.
734See also :link reftype=hd res=&HPM_SRC_FIND..Find:elink.
735and :link reftype=hd res=&HPM_SRC_FINDPREV..Find previous:elink..
736
737.************************************************************************
738.* Find previous
739.************************************************************************
740:h3 res=&HPM_SRC_FINDPREV..Help for Find previous
741:i2 refid='src.view'.Find previous
742:i2 refid='pmgdb'.Find previous
743:lm margin=1.
744:p.
745Use this choice to search for the previous occurrence of a regular expression.
746The search continues from the line preceding the line containing the
747previously found match.
748See also :link reftype=hd res=&HPM_SRC_FIND..Find:elink.
749and :link reftype=hd res=&HPM_SRC_FINDNEXT..Find next:elink..
750
751.************************************************************************
752.* Go to line
753.************************************************************************
754:h3 res=&HPM_SRC_GOTO..Help for Go to line
755:i2 refid='src.view'.Go to line
756:i2 refid='pmgdb'.Go to line
757:lm margin=1.
758:p.
759Use this choice to show a line of the current source file
760specified by line number. This choice opens the
761:link reftype=hd res=&HPD_GOTO..Go to line:elink. dialog box.
762
763.************************************************************************
764.* Run
765.************************************************************************
766:h2 res=&HPM_SRC_RUNMENU..Help for Run
767:i2 refid='pmgdb'.Run menu (source window)
768:i1 id='src.run'.Run menu choices
769:lm margin=1.
770:p.
771The Run menu contains the following choices&colon.
772:parml compact.
773:pt.:link reftype=hd res=&HPM_GO..Go:elink.
774:pd.Continue (or start) program.
775:pt.:link reftype=hd res=&HPM_STEPOVER..Step over:elink.
776:pd.Step program, proceeding through subroutine calls.
777:pt.:link reftype=hd res=&HPM_STEPINTO..Step into:elink.
778:pd.Step program until it reaches a different source line.
779:pt.:link reftype=hd res=&HPM_FINISH..Finish:elink.
780:pd.Execute until selected stack frame returns.
781:pt.:link reftype=hd res=&HPM_ISTEPOVER..Insn step over:elink.
782:pd.Step one instruction, proceeding through subroutine calls.
783:pt.:link reftype=hd res=&HPM_ISTEPINTO..Insn step into:elink.
784:pd.Step one instruction.
785:pt.:link reftype=hd res=&HPM_SRC_UNTIL..Until:elink.
786:pd.Execute until the program reaches the selected line.
787:pt.:link reftype=hd res=&HPM_SRC_JUMP..Jump:elink.
788:pd.Jump to the selected line.
789:eparml.
790
791.************************************************************************
792.* Until
793.************************************************************************
794:h3 res=&HPM_SRC_UNTIL..Help for Until
795:i2 refid='src.run'.Until
796:i2 refid='pmgdb'.Until
797:lm margin=1.
798:p.
799Use this choice to let the program run until it reaches the selected line.
800Click with the first mouse button on a line number in a source window to
801select a line.
802
803.************************************************************************
804.* Jump
805.************************************************************************
806:h3 res=&HPM_SRC_JUMP..Help for Jump
807:i2 refid='src.run'.Jump
808:i2 refid='pmgdb'.Jump
809:lm margin=1.
810:p.
811Use this choice to jump to the selected line. Execution will continue
812from that line. Click with the first mouse button on a line number in
813a source window to select a line.
814
815.************************************************************************
816.* Breakpoints
817.************************************************************************
818:h2 res=&HPM_SRC_BRKPTMENU..Help for Breakpoints
819:i2 refid='src'.Breakpoints menu
820:i1 id='src.brkpt'.Breakpoints menu choices (source window)
821:lm margin=1.
822:p.
823The Breakpoints menu contains the following choices&colon.
824:parml compact.
825:pt.:link reftype=hd res=&HPM_BRKPT_LINE..On line:elink.
826:pd.Set a breakpoint on a line.
827:pt.:link reftype=hd res=&HPM_BRKPT_LIST..List:elink.
828:pd.Open the breakpoints window.
829:eparml.
830
831.************************************************************************
832.* Display
833.************************************************************************
834:h2 res=&HPM_SRC_DSPMENU..Help for Display
835:i2 refid='src'.Display menu
836:i1 id='src.dsp'.Display menu choices
837:lm margin=1.
838:p.
839The Display menu contains the following choices&colon.
840:parml compact.
841:pt.:link reftype=hd res=&HPM_DSP_ADD..Add:elink.
842:pd.Add a display.
843:pt.:link reftype=hd res=&HPM_SRC_DSP_SHOW..Show:elink.
844:pd.Show the display window.
845:eparml.
846
847.************************************************************************
848.* Show
849.************************************************************************
850:h3 res=&HPM_SRC_DSP_SHOW..Help for Show
851:i2 refid='src.dsp'.Show
852:i2 refid='pmgdb'.Show
853:lm margin=1.
854:p.
855Use this choice to show the display window.
856
857.************************************************************************
858.* Options
859.************************************************************************
860:h2 res=&HPM_SRC_OPTIONSMENU..Help for Options
861:i2 refid='src'.Options menu
862:i1 id='src.options'.Options menu choices
863:lm margin=1.
864:p.
865The Options menu contains the following choices&colon.
866:parml compact.
867:pt.:link reftype=hd res=&HPM_PMDEBUGMODE..PM debugging mode:elink.
868:pd.Select the mode for debugging PM applications.
869:eparml.
870
871.************************************************************************
872.* Windows
873.************************************************************************
874:h2 res=&HPM_SRC_WINMENU..Help for Windows
875:i2 refid='src'.Windows menu
876:i1 id='src.win'.Windows menu choices (source window)
877:lm margin=1.
878:p.
879The Windows menu contains the following choices&colon.
880:parml compact.
881:pt.:link reftype=hd res=&HPM_WIN_CMD..Command:elink.
882:pd.Show the command window.
883:pt.:link reftype=hd res=&HPM_WIN_SRCS..Source files:elink.
884:pd.Show the source files window.
885:pt.:link reftype=hd res=&HPM_WIN_BRK..Breakpoints:elink.
886:pd.Show the breakpoints window.
887:pt.:link reftype=hd res=&HPM_WIN_DSP..Display:elink.
888:pd.Show the display window.
889:pt.:link reftype=hd res=&HPM_WIN_THR..Threads:elink.
890:pd.Show the threads window.
891:pt.:link reftype=hd res=&HPM_WIN_REG..Register:elink.
892:pd.Show the register window.
893:eparml.
894
895.************************************************************************
896.* Command
897.************************************************************************
898:h3 res=&HPM_WIN_CMD..Help for Command
899:i2 refid='src.win'.Command
900:i2 refid='pmgdb'.Command
901:lm margin=1.
902:p.
903Use this choice to show the command window.
904
905.************************************************************************
906.* Help
907.************************************************************************
908:h2 res=&HPM_SRC_HELPMENU..Help for Help
909:i2 refid='src'.Help menu
910:i1 id='src.help'.Help menu choices
911:lm margin=1.
912:p.
913The Help menu contains the following choices&colon.
914:parml compact.
915:pt.:link reftype=hd res=&HPM_HELP_HELP..Help for help:elink.
916:pd.Display help for help.
917:pt.:link reftype=hd res=&HPM_HELP_EXT..Extended help:elink.
918:pd.Display extended help.
919:pt.:link reftype=hd res=&HPM_HELP_KEYS..Keys help:elink.
920:pd.Display help about keys.
921:pt.:link reftype=hd res=&HPM_HELP_INDEX..Help index:elink.
922:pd.Display the help index.
923:pt.:link reftype=hd res=&HPM_HELP_CONTENTS..Help index:elink.
924:pd.Display the help contents.
925:eparml.
926
927.************************************************************************
928.* Keys help (source window)
929.************************************************************************
930:h1 res=&HELP_SRC_KEYS..Keys help (source window)
931:i1 id='src.keys'.Keys (source window)
932:lm margin=1.
933:p.
934You can use the following keys in a source window&colon.
935:dl tsize=20 compact.
936:dt.Up arrow:dd.Scroll down by one line.
937:dt.Down arrow:dd.Scroll up by one line.
938:dt.Page Up:dd.Scroll down by one window.
939:dt.Page Down:dd.Scroll up by one window.
940:dt.Left:dd.Scroll left by one character (average character width).
941:dt.Right:dd.Scroll right by one character (average character width).
942:dt.Ctrl+Page Up:dd.Scroll down right by one window.
943:dt.Ctrl+Page Down:dd.Scroll left by one window.
944:edl.
945:p.
946Accelerator keys are missed out in the list above.
947
948.************************************************************************
949.* Source files window
950.************************************************************************
951:h1 res=&HELP_SRCS_WINDOW..Help for source files window
952:i1 id='srcs'.pmgdb source files window
953:lm margin=1.
954:p.
955The source files window of :hp2.pmgdb:ehp2. lists the names of
956all source files for modules compiled with debugging enabled.
957Double clicking with the first mouse button on a file name will show
958an existing source window or open a new source window for that file.
959Closing the source files window doesn't terminate :hp2.pmgdb:ehp2..
960:p.
961Help is available on the following topics&colon.
962:p.
963:ul.
964:li.:link reftype=hd res=&HPM_SRCS_FILEMENU..File menu:elink.
965:li.:link reftype=hd res=&HPM_SRCS_WINMENU..Windows menu:elink.
966:li.:link reftype=hd res=&HPM_SRCS_HELPMENU..Help menu:elink.
967:li.:link reftype=hd res=&HELP_SRCS_KEYS..Keys in the source files
968window:elink.
969:eul.
970
971.************************************************************************
972.* File
973.************************************************************************
974:h2 res=&HPM_SRCS_FILEMENU..Help for File
975:i2 refid='srcs'.File menu
976:i1 id='srcs.file'.File menu choices (source files window)
977:lm margin=1.
978:p.
979The File menu contains the following choices&colon.
980:parml compact.
981:pt.:link reftype=hd res=&HPM_EXIT..Exit:elink.
982:pd.Terminate :hp2.pmgdb:ehp2..
983:eparml.
984
985.************************************************************************
986.* Windows
987.************************************************************************
988:h2 res=&HPM_SRCS_WINMENU..Help for Windows
989:i2 refid='srcs'.Windows menu
990:i1 id='srcs.win'.Windows menu choices (source files window)
991:lm margin=1.
992:p.
993The Windows menu contains the following choices&colon.
994:parml compact.
995:pt.:link reftype=hd res=&HPM_WIN_CMD..Command:elink.
996:pd.Show the command window.
997:pt.:link reftype=hd res=&HPM_WIN_BRK..Breakpoints:elink.
998:pd.Show the breakpoints window.
999:pt.:link reftype=hd res=&HPM_WIN_DSP..Display:elink.
1000:pd.Show the display window.
1001:pt.:link reftype=hd res=&HPM_WIN_THR..Threads:elink.
1002:pd.Show the threads window.
1003:pt.:link reftype=hd res=&HPM_WIN_REG..Register:elink.
1004:pd.Show the register window.
1005:eparml.
1006
1007.************************************************************************
1008.* Help
1009.************************************************************************
1010:h2 res=&HPM_SRCS_HELPMENU..Help for Help
1011:i2 refid='srcs'.Help menu
1012:i1 id='srcs.help'.Help menu choices
1013:lm margin=1.
1014:p.
1015The Help menu contains the following choices&colon.
1016:parml compact.
1017:pt.:link reftype=hd res=&HPM_HELP_HELP..Help for help:elink.
1018:pd.Display help for help.
1019:pt.:link reftype=hd res=&HPM_HELP_EXT..Extended help:elink.
1020:pd.Display extended help.
1021:pt.:link reftype=hd res=&HPM_HELP_KEYS..Keys help:elink.
1022:pd.Display help about keys.
1023:pt.:link reftype=hd res=&HPM_HELP_INDEX..Help index:elink.
1024:pd.Display the help index.
1025:pt.:link reftype=hd res=&HPM_HELP_CONTENTS..Help index:elink.
1026:pd.Display the help contents.
1027:eparml.
1028
1029.************************************************************************
1030.* Keys help (source files window)
1031.************************************************************************
1032:h1 res=&HELP_SRCS_KEYS..Keys help (source files window)
1033:i1 id='srcs.keys'.Keys (source files window)
1034:lm margin=1.
1035:p.
1036You can use the following keys in the source files window&colon.
1037:dl tsize=20 compact.
1038:edl.
1039:p.
1040Accelerator keys are missed out in the list above.
1041
1042.************************************************************************
1043.* Breakpoints window
1044.************************************************************************
1045:h1 res=&HELP_BRK_WINDOW..Help for breakpoints window
1046:i1 id='brk'.pmgdb breakpoints window
1047:lm margin=1.
1048:p.
1049The breakpoints window of :hp2.pmgdb:ehp2. shows all the breakpoints.
1050For each breakpoint, the following values are displayed&colon.
1051:dl tsize=12 compact.
1052:dt.No:dd.The number of the breakpoint as maintained by GDB. Modifying
1053a breakpoint may change its number
1054:dt.Ena:dd.y if the breakpoint is enabled, n if the breakpoint is disabled
1055:dt.Address:dd.Address of the breakpoint
1056:dt.Source:dd.Source file for the breakpoint address
1057:dt.Line:dd.Line number for the breakpoint address
1058:dt.Disp:dd.Disposition of the breakpoint: `keep' means that the breakpoint
1059remains enabled when hit, `dis' means that the breakpoint will be disabled
1060when hit, `del' means that the breakpoint will be deleted when hit.
1061:dt.Ign:dd.Ignore count. The breakpoint will be ignored this many
1062times.
1063:dt.Cond:dd.Condition. This expression is evaluated whenever the
1064breakpoint is hit; the breakpoint breaks only if the expression is true.
1065:edl.
1066:p.
1067You can toggle the enabled state of a breakpoint by double clicking
1068with the first mouse button on the value in the `Ena' column. You can
1069view the source code at the breakpoint by double clicking on the value
1070in the `Source' or `Line' column.
1071Closing the breakpoints window doesn't terminate :hp2.pmgdb:ehp2..
1072:p.
1073Help is available on the following topics&colon.
1074:p.
1075:ul.
1076:li.:link reftype=hd res=&HPM_BRK_FILEMENU..File menu:elink.
1077:li.:link reftype=hd res=&HPM_BRK_EDITMENU..Edit menu:elink.
1078:li.:link reftype=hd res=&HPM_BRK_BRKPTMENU..Breakpoints menu:elink.
1079:li.:link reftype=hd res=&HPM_BRK_WINMENU..Windows menu:elink.
1080:li.:link reftype=hd res=&HPM_BRK_HELPMENU..Help menu:elink.
1081:li.:link reftype=hd res=&HELP_BRK_KEYS..Keys in the breakpoints window:elink.
1082:eul.
1083
1084.************************************************************************
1085.* File
1086.************************************************************************
1087:h2 res=&HPM_BRK_FILEMENU..Help for File
1088:i2 refid='brk'.File menu
1089:i1 id='brk.file'.File menu choices (breakpoints window)
1090:lm margin=1.
1091:p.
1092The File menu contains the following choices&colon.
1093:parml compact.
1094:pt.:link reftype=hd res=&HPM_EXIT..Exit:elink.
1095:pd.Terminate :hp2.pmgdb:ehp2..
1096:eparml.
1097
1098.************************************************************************
1099.* Edit
1100.************************************************************************
1101:h2 res=&HPM_BRK_EDITMENU..Help for Edit
1102:i2 refid='brk'.Edit menu
1103:i1 id='brk.edit'.Edit menu choices (breakpoints window)
1104:lm margin=1.
1105:p.
1106The Edit menu contains the following choices&colon.
1107:parml compact.
1108:pt.:link reftype=hd res=&HPM_BRK_MODIFY..Modify:elink.
1109:pd.Modify the selected breakpoint.
1110:pt.:link reftype=hd res=&HPM_BRK_ENABLE..Enable:elink.
1111:pd.Enable the selected breakpoint.
1112:pt.:link reftype=hd res=&HPM_BRK_DISABLE..Disable:elink.
1113:pd.Disable the selected breakpoint.
1114:pt.:link reftype=hd res=&HPM_BRK_DELETE..Delete:elink.
1115:pd.Delete the selected breakpoint.
1116:eparml.
1117
1118.************************************************************************
1119.* Modify
1120.************************************************************************
1121:h3 res=&HPM_BRK_MODIFY..Help for Modify
1122:i2 refid='brk.edit'.Modify
1123:i2 refid='pmgdb'.Modify breakpoint
1124:lm margin=1.
1125:p.
1126Use this choice to modify the selected breakpoint. Click with the
1127first mouse button select a breakpoint.
1128
1129.************************************************************************
1130.* Enable
1131.************************************************************************
1132:h3 res=&HPM_BRK_ENABLE..Help for Enable
1133:i2 refid='brk.edit'.Enable
1134:i2 refid='pmgdb'.Enable
1135:lm margin=1.
1136:p.
1137Use this choice to enable the selected breakpoint. Click with the
1138first mouse button select a breakpoint.
1139
1140.************************************************************************
1141.* Disable
1142.************************************************************************
1143:h3 res=&HPM_BRK_DISABLE..Help for Disable
1144:i2 refid='brk.edit'.Disable
1145:i2 refid='pmgdb'.Disable breakpoint
1146:lm margin=1.
1147:p.
1148Use this choice to disable the selected breakpoint. Click with the
1149first mouse button select a breakpoint.
1150
1151.************************************************************************
1152.* Delete
1153.************************************************************************
1154:h3 res=&HPM_BRK_DELETE..Help for Delete
1155:i2 refid='brk.edit'.Delete
1156:i2 refid='pmgdb'.Delete breakpoint
1157:lm margin=1.
1158:p.
1159Use this choice to delete the selected breakpoint. Click with the
1160first mouse button select a breakpoint.
1161
1162.************************************************************************
1163.* Breakpoints
1164.************************************************************************
1165:h2 res=&HPM_BRK_BRKPTMENU..Help for Breakpoints
1166:i2 refid='brk'.Breakpoints menu
1167:i1 id='brk.brkpt'.Breakpoints menu choices (breakpoints window)
1168:lm margin=1.
1169:p.
1170The Breakpoints menu contains the following choices&colon.
1171:parml compact.
1172:pt.:link reftype=hd res=&HPM_BRKPT_LINE..On line:elink.
1173:pd.Set a breakpoint on a line.
1174:pt.:link reftype=hd res=&HPM_BRK_REFRESH..Refresh:elink.
1175:pd.Refresh the window contents.
1176:eparml.
1177
1178.************************************************************************
1179.* Refresh
1180.************************************************************************
1181:h3 res=&HPM_BRK_REFRESH..Help for Refresh
1182:i2 refid='brk.brkpt'.Refresh
1183:i2 refid='pmgdb'.Refresh (breakpoints window)
1184:lm margin=1.
1185:p.
1186Use this choice to refresh the contents of the breakpoints window.
1187Due to shortcomings in GDB, :hp2.pmgdb:ehp2. does not always automatically
1188update the breakpoints window to reflect changes of the breakpoints.
1189For instance, the ignore count is not updated when the debuggee stops.
1190
1191.************************************************************************
1192.* Windows
1193.************************************************************************
1194:h2 res=&HPM_BRK_WINMENU..Help for Windows
1195:i2 refid='brk'.Windows menu
1196:i1 id='brk.win'.Windows menu choices (breakpoints window)
1197:lm margin=1.
1198:p.
1199The Windows menu contains the following choices&colon.
1200:parml compact.
1201:pt.:link reftype=hd res=&HPM_WIN_CMD..Command:elink.
1202:pd.Show the command window.
1203:pt.:link reftype=hd res=&HPM_WIN_SRCS..Source files:elink.
1204:pd.Show the source files window.
1205:pt.:link reftype=hd res=&HPM_WIN_DSP..Display:elink.
1206:pd.Show the display window.
1207:pt.:link reftype=hd res=&HPM_WIN_THR..Threads:elink.
1208:pd.Show the threads window.
1209:pt.:link reftype=hd res=&HPM_WIN_REG..Register:elink.
1210:pd.Show the register window.
1211:eparml.
1212
1213.************************************************************************
1214.* Help
1215.************************************************************************
1216:h2 res=&HPM_BRK_HELPMENU..Help for Help
1217:i2 refid='brk'.Help menu
1218:i1 id='brk.help'.Help menu choices
1219:lm margin=1.
1220:p.
1221The Help menu contains the following choices&colon.
1222:parml compact.
1223:pt.:link reftype=hd res=&HPM_HELP_HELP..Help for help:elink.
1224:pd.Display help for help.
1225:pt.:link reftype=hd res=&HPM_HELP_EXT..Extended help:elink.
1226:pd.Display extended help.
1227:pt.:link reftype=hd res=&HPM_HELP_KEYS..Keys help:elink.
1228:pd.Display help about keys.
1229:pt.:link reftype=hd res=&HPM_HELP_INDEX..Help index:elink.
1230:pd.Display the help index.
1231:pt.:link reftype=hd res=&HPM_HELP_CONTENTS..Help index:elink.
1232:pd.Display the help contents.
1233:eparml.
1234
1235.************************************************************************
1236.* Keys help (breakpoints window)
1237.************************************************************************
1238:h1 res=&HELP_BRK_KEYS..Keys help (breakpoints window)
1239:i1 id='brk.keys'.Keys (breakpoints window)
1240:lm margin=1.
1241:p.
1242You can use the following keys in the breakpoints window&colon.
1243:dl tsize=20 compact.
1244:edl.
1245:p.
1246Accelerator keys are missed out in the list above.
1247
1248.************************************************************************
1249.* Display window
1250.************************************************************************
1251:h1 res=&HELP_DSP_WINDOW..Help for display window
1252:i1 id='dsp'.pmgdb display window
1253:lm margin=1.
1254:p.
1255The display window of :hp2.pmgdb:ehp2. shows all the displays.
1256For each display, the following values are displayed&colon.
1257:dl tsize=12 compact.
1258:dt.No:dd.The number of the display as maintained by GDB. Modifying
1259a display may change its number
1260:dt.Ena:dd.y if the display is enabled, n if the display is disabled
1261:dt.Fmt:dd.Format to be used for displaying the value
1262:dt.Expr:dd.Expression to be evaluated
1263:dt.Value:dd.Value of the expression (if the display is enabled)
1264:edl.
1265:p.
1266You can toggle the enabled state of a display by double clicking
1267with the first mouse button on the value in the `Ena' column. You can
1268modify a display by double clicking on the value
1269in the `Fmt' or `Expr' column.
1270Closing the display window doesn't terminate :hp2.pmgdb:ehp2..
1271:p.
1272Help is available on the following topics&colon.
1273:p.
1274:ul.
1275:li.:link reftype=hd res=&HPM_DSP_FILEMENU..File menu:elink.
1276:li.:link reftype=hd res=&HPM_DSP_EDITMENU..Edit menu:elink.
1277:li.:link reftype=hd res=&HPM_DSP_WINMENU..Windows menu:elink.
1278:li.:link reftype=hd res=&HPM_DSP_HELPMENU..Help menu:elink.
1279:li.:link reftype=hd res=&HELP_DSP_KEYS..Keys in the display window:elink.
1280:eul.
1281
1282.************************************************************************
1283.* File
1284.************************************************************************
1285:h2 res=&HPM_DSP_FILEMENU..Help for File
1286:i2 refid='dsp'.File menu
1287:i1 id='dsp.file'.File menu choices (display window)
1288:lm margin=1.
1289:p.
1290The File menu contains the following choices&colon.
1291:parml compact.
1292:pt.:link reftype=hd res=&HPM_EXIT..Exit:elink.
1293:pd.Terminate :hp2.pmgdb:ehp2..
1294:eparml.
1295
1296.************************************************************************
1297.* Edit
1298.************************************************************************
1299:h2 res=&HPM_DSP_EDITMENU..Help for Edit
1300:i2 refid='dsp'.Edit menu
1301:i1 id='dsp.edit'.Edit menu choices (display window)
1302:lm margin=1.
1303:p.
1304The Edit menu contains the following choices&colon.
1305:parml compact.
1306:pt.:link reftype=hd res=&HPM_DSP_ADD..Add:elink.
1307:pd.Add a display.
1308:pt.:link reftype=hd res=&HPM_DSP_MODIFY..Modify:elink.
1309:pd.Modify the selected display.
1310:pt.:link reftype=hd res=&HPM_DSP_ENABLE..Enable:elink.
1311:pd.Enable the selected display.
1312:pt.:link reftype=hd res=&HPM_DSP_DISABLE..Disable:elink.
1313:pd.Disable the selected display.
1314:pt.:link reftype=hd res=&HPM_DSP_FORMAT..Format:elink.
1315:pd.Change format for selected display.
1316:pt.:link reftype=hd res=&HPM_DSP_DELETE..Delete:elink.
1317:pd.Delete the selected display.
1318:pt.:link reftype=hd res=&HPM_DSP_DEREFERENCE..Dereference:elink.
1319:pd.Display the value pointed to by a pointer.
1320:pt.:link reftype=hd res=&HPM_DSP_ENABLE_ALL..Enable all:elink.
1321:pd.Enable all displays.
1322:pt.:link reftype=hd res=&HPM_DSP_DISABLE_ALL..Disable all:elink.
1323:pd.Disable all displays.
1324:pt.:link reftype=hd res=&HPM_DSP_DELETE_ALL..Delete all:elink.
1325:pd.Delete all displays.
1326:eparml.
1327
1328.************************************************************************
1329.* Add
1330.************************************************************************
1331:h3 res=&HPM_DSP_ADD..Help for Add
1332:i2 refid='dsp.dsp'.Add
1333:i2 refid='pmgdb'.Add display
1334:lm margin=1.
1335:p.
1336Use this choice to add a display. This choice opens the
1337:link reftype=hd res=&HPD_DISPLAY..Display:elink. dialog box.
1338You can also double click with the first mouse button on a variable
1339in a source window to add it to the display window.
1340
1341.************************************************************************
1342.* Modify
1343.************************************************************************
1344:h3 res=&HPM_DSP_MODIFY..Help for Modify
1345:i2 refid='dsp.edit'.Modify
1346:i2 refid='pmgdb'.Modify display
1347:lm margin=1.
1348:p.
1349Use this choice to modify the selected display. This choice opens the
1350:link reftype=hd res=&HPD_DISPLAY..Display:elink. dialog box. Click with the
1351first mouse button select a display.
1352
1353.************************************************************************
1354.* Enable
1355.************************************************************************
1356:h3 res=&HPM_DSP_ENABLE..Help for Enable
1357:i2 refid='dsp.edit'.Enable
1358:i2 refid='pmgdb'.Enable display
1359:lm margin=1.
1360:p.
1361Use this choice to enable the selected display. Click with the
1362first mouse button select a display.
1363
1364.************************************************************************
1365.* Disable
1366.************************************************************************
1367:h3 res=&HPM_DSP_DISABLE..Help for Disable
1368:i2 refid='dsp.edit'.Disable
1369:i2 refid='pmgdb'.Disable display
1370:lm margin=1.
1371:p.
1372Use this choice to disable the selected display. Click with the
1373first mouse button select a display.
1374
1375.************************************************************************
1376.* Format
1377.************************************************************************
1378:h3 res=&HPM_DSP_FORMAT..Help for Format
1379:i2 refid='dsp.edit'.Format
1380:i2 refid='pmgdb'.Format
1381:lm margin=1.
1382:p.
1383Use this choice to change the format of the selected display. Click with the
1384first mouse button select a display.
1385
1386.************************************************************************
1387.* Delete
1388.************************************************************************
1389:h3 res=&HPM_DSP_DELETE..Help for Delete
1390:i2 refid='dsp.edit'.Delete
1391:i2 refid='pmgdb'.Delete display
1392:lm margin=1.
1393:p.
1394Use this choice to delete the selected display. Click with the
1395first mouse button select a display.
1396
1397.************************************************************************
1398.* Dereference
1399.************************************************************************
1400:h3 res=&HPM_DSP_DEREFERENCE..Help for Dereference
1401:i2 refid='dsp.edit'.Dereference
1402:i2 refid='pmgdb'.Dereference
1403:lm margin=1.
1404:p.
1405Use this choice to replace the selected display with one which shows
1406the object pointed to by the display's value. This can be done only
1407if the selected display shows a pointer. Click with the first mouse
1408button select a display.
1409:note.The value is dereferenced in the current context, not in the
1410context which was active when the display was created.
1411
1412.************************************************************************
1413.* Enable all
1414.************************************************************************
1415:h3 res=&HPM_DSP_ENABLE_ALL..Help for Enable all
1416:i2 refid='dsp.edit'.Enable all
1417:i2 refid='pmgdb'.Enable all
1418:lm margin=1.
1419:p.
1420Use this choice to enable all displays.
1421
1422.************************************************************************
1423.* Disable all
1424.************************************************************************
1425:h3 res=&HPM_DSP_DISABLE_ALL..Help for Disable all
1426:i2 refid='dsp.edit'.Disable all
1427:i2 refid='pmgdb'.Disable all
1428:lm margin=1.
1429:p.
1430Use this choice to disable all displays.
1431
1432.************************************************************************
1433.* Delete all
1434.************************************************************************
1435:h3 res=&HPM_DSP_DELETE_ALL..Help for Delete all
1436:i2 refid='dsp.edit'.Delete all
1437:i2 refid='pmgdb'.Delete all
1438:lm margin=1.
1439:p.
1440Use this choice to delete all displays.
1441
1442.************************************************************************
1443.* Windows
1444.************************************************************************
1445:h2 res=&HPM_DSP_WINMENU..Help for Windows
1446:i2 refid='dsp'.Windows menu
1447:i1 id='dsp.win'.Windows menu choices (display window)
1448:lm margin=1.
1449:p.
1450The Windows menu contains the following choices&colon.
1451:parml compact.
1452:pt.:link reftype=hd res=&HPM_WIN_CMD..Command:elink.
1453:pd.Show the command window.
1454:pt.:link reftype=hd res=&HPM_WIN_SRCS..Source files:elink.
1455:pd.Show the source files window.
1456:pt.:link reftype=hd res=&HPM_WIN_BRK..Breakpoints:elink.
1457:pd.Show the breakpoints window.
1458:pt.:link reftype=hd res=&HPM_WIN_THR..Threads:elink.
1459:pd.Show the threads window.
1460:pt.:link reftype=hd res=&HPM_WIN_REG..Register:elink.
1461:pd.Show the register window.
1462:eparml.
1463
1464.************************************************************************
1465.* Help
1466.************************************************************************
1467:h2 res=&HPM_DSP_HELPMENU..Help for Help
1468:i2 refid='dsp'.Help menu
1469:i1 id='dsp.help'.Help menu choices
1470:lm margin=1.
1471:p.
1472The Help menu contains the following choices&colon.
1473:parml compact.
1474:pt.:link reftype=hd res=&HPM_HELP_HELP..Help for help:elink.
1475:pd.Display help for help.
1476:pt.:link reftype=hd res=&HPM_HELP_EXT..Extended help:elink.
1477:pd.Display extended help.
1478:pt.:link reftype=hd res=&HPM_HELP_KEYS..Keys help:elink.
1479:pd.Display help about keys.
1480:pt.:link reftype=hd res=&HPM_HELP_INDEX..Help index:elink.
1481:pd.Display the help index.
1482:pt.:link reftype=hd res=&HPM_HELP_CONTENTS..Help index:elink.
1483:pd.Display the help contents.
1484:eparml.
1485
1486.************************************************************************
1487.* Keys help (display window)
1488.************************************************************************
1489:h1 res=&HELP_DSP_KEYS..Keys help (display window)
1490:i1 id='dsp.keys'.Keys (display window)
1491:lm margin=1.
1492:p.
1493You can use the following keys in the display window&colon.
1494:dl tsize=20 compact.
1495:edl.
1496:p.
1497Accelerator keys are missed out in the list above.
1498
1499.************************************************************************
1500.* Threads window
1501.************************************************************************
1502:h1 res=&HELP_THR_WINDOW..Help for threads window
1503:i1 id='thr'.pmgdb threads window
1504:lm margin=1.
1505:p.
1506The threads window of :hp2.pmgdb:ehp2. shows all threads.
1507For each thread, the following values are displayed&colon.
1508:dl tsize=12 compact.
1509:dt.TID:dd.The thread ID
1510:dt.Ena:dd.y if the thread is enabled, n if the thread is disabled
1511:edl.
1512:p.
1513You can toggle the enabled state of a thread by double clicking
1514with the first mouse button on the value in the `Ena' column.
1515Closing the threads window doesn't terminate :hp2.pmgdb:ehp2..
1516:p.
1517Help is available on the following topics&colon.
1518:p.
1519:ul.
1520:li.:link reftype=hd res=&HPM_THR_FILEMENU..File menu:elink.
1521:li.:link reftype=hd res=&HPM_THR_EDITMENU..Edit menu:elink.
1522:li.:link reftype=hd res=&HPM_THR_WINMENU..Windows menu:elink.
1523:li.:link reftype=hd res=&HELP_THR_KEYS..Keys in the threads window:elink.
1524:eul.
1525
1526.************************************************************************
1527.* File
1528.************************************************************************
1529:h2 res=&HPM_THR_FILEMENU..Help for File
1530:i2 refid='thr'.File menu
1531:i1 id='thr.file'.File menu choices (threads window)
1532:lm margin=1.
1533:p.
1534The File menu contains the following choices&colon.
1535:parml compact.
1536:pt.:link reftype=hd res=&HPM_EXIT..Exit:elink.
1537:pd.Terminate :hp2.pmgdb:ehp2..
1538:eparml.
1539
1540.************************************************************************
1541.* Edit
1542.************************************************************************
1543:h2 res=&HPM_THR_EDITMENU..Help for Edit
1544:i2 refid='thr'.Edit menu
1545:i1 id='thr.edit'.Edit menu choices (threads window)
1546:lm margin=1.
1547:p.
1548The Edit menu contains the following choices&colon.
1549:parml compact.
1550:pt.:link reftype=hd res=&HPM_THR_ENABLE..Enable (thaw):elink.
1551:pd.Enable (thaw) the selected thread.
1552:pt.:link reftype=hd res=&HPM_THR_DISABLE..Disable (freeze):elink.
1553:pd.Disable (freeze) the selected thread.
1554:pt.:link reftype=hd res=&HPM_THR_SWITCH..Switch to:elink.
1555:pd.Switch to the selected thread.
1556:eparml.
1557
1558.************************************************************************
1559.* Enable
1560.************************************************************************
1561:h3 res=&HPM_THR_ENABLE..Help for Enable
1562:i2 refid='thr.edit'.Enable
1563:i2 refid='pmgdb'.Enable thread
1564:lm margin=1.
1565:p.
1566Use this choice to enable the selected thread. Click with the
1567first mouse button select a thread.
1568
1569.************************************************************************
1570.* Disable
1571.************************************************************************
1572:h3 res=&HPM_THR_DISABLE..Help for Disable
1573:i2 refid='thr.edit'.Disable
1574:i2 refid='pmgdb'.Disable thread
1575:lm margin=1.
1576:p.
1577Use this choice to disable the selected thread. Click with the
1578first mouse button select a thread.
1579
1580.************************************************************************
1581.* Switch to
1582.************************************************************************
1583:h3 res=&HPM_THR_SWITCH..Help for Switch to
1584:i2 refid='thr.edit'.Switch to
1585:i2 refid='pmgdb'.Switch to thread
1586:lm margin=1.
1587:p.
1588Use this choice to switch to the selected thread. Click with the
1589first mouse button select a thread. You can also switch to a thread
1590by double clicking on the thread ID (TID).
1591
1592.************************************************************************
1593.* Windows
1594.************************************************************************
1595:h2 res=&HPM_THR_WINMENU..Help for Windows
1596:i2 refid='thr'.Windows menu
1597:i1 id='thr.win'.Windows menu choices (threads window)
1598:lm margin=1.
1599:p.
1600The Windows menu contains the following choices&colon.
1601:parml compact.
1602:pt.:link reftype=hd res=&HPM_WIN_CMD..Command:elink.
1603:pd.Show the command window.
1604:pt.:link reftype=hd res=&HPM_WIN_SRCS..Source files:elink.
1605:pd.Show the source files window.
1606:pt.:link reftype=hd res=&HPM_WIN_BRK..Breakpoints:elink.
1607:pd.Show the breakpoints window.
1608:pt.:link reftype=hd res=&HPM_WIN_DSP..Display:elink.
1609:pd.Show the display window.
1610:pt.:link reftype=hd res=&HPM_WIN_REG..Register:elink.
1611:pd.Show the register window.
1612:eparml.
1613
1614.************************************************************************
1615.* Keys help (threads window)
1616.************************************************************************
1617:h1 res=&HELP_THR_KEYS..Keys help (threads window)
1618:i1 id='thr.keys'.Keys (threads window)
1619:lm margin=1.
1620:p.
1621You can use the following keys in the threads window&colon.
1622:dl tsize=20 compact.
1623:edl.
1624:p.
1625Accelerator keys are missed out in the list above.
1626
1627.************************************************************************
1628.* Register window
1629.************************************************************************
1630:h1 res=&HELP_REG_WINDOW..Help for register window
1631:i1 id='reg'.pmgdb register window
1632:lm margin=1.
1633:p.
1634The register window of :hp2.pmgdb:ehp2. shows the values of the
1635CPU registers. Closing the register window doesn't terminate
1636:hp2.pmgdb:ehp2..
1637:p.
1638Help is available on the following topics&colon.
1639:p.
1640:ul.
1641:li.:link reftype=hd res=&HPM_REG_FILEMENU..File menu:elink.
1642:li.:link reftype=hd res=&HPM_REG_VIEWMENU..View menu:elink.
1643:li.:link reftype=hd res=&HPM_REG_WINMENU..Windows menu:elink.
1644:li.:link reftype=hd res=&HELP_REG_KEYS..Keys in the register window:elink.
1645:eul.
1646
1647.************************************************************************
1648.* File
1649.************************************************************************
1650:h2 res=&HPM_REG_FILEMENU..Help for File
1651:i2 refid='reg'.File menu
1652:i1 id='reg.file'.File menu choices (register window)
1653:lm margin=1.
1654:p.
1655The File menu contains the following choices&colon.
1656:parml compact.
1657:pt.:link reftype=hd res=&HPM_EXIT..Exit:elink.
1658:pd.Terminate :hp2.pmgdb:ehp2..
1659:eparml.
1660
1661.************************************************************************
1662.* View
1663.************************************************************************
1664:h2 res=&HPM_REG_VIEWMENU..Help for View
1665:i2 refid='reg'.View menu
1666:i1 id='reg.view'.View menu choices (register window)
1667:lm margin=1.
1668:p.
1669The View menu contains the following choices&colon.
1670:parml compact.
1671:pt.:link reftype=hd res=&HPM_REG_REFRESH..Refresh:elink.
1672:pd.Refresh the window contents.
1673:eparml.
1674
1675.************************************************************************
1676.* Refresh
1677.************************************************************************
1678:h3 res=&HPM_REG_REFRESH..Help for Refresh
1679:i2 refid='reg.view'.Refresh
1680:i2 refid='pmgdb'.Refresh (register window)
1681:lm margin=1.
1682:p.
1683Use this choice to refresh the contents of the register window.
1684:hp2.pmgdb:ehp2. does not automatically update the register window
1685to reflect modifications of the register values done with GDB commands.
1686
1687.************************************************************************
1688.* Windows
1689.************************************************************************
1690:h2 res=&HPM_REG_WINMENU..Help for Windows
1691:i2 refid='reg'.Windows menu
1692:i1 id='reg.win'.Windows menu choices (register window)
1693:lm margin=1.
1694:p.
1695The Windows menu contains the following choices&colon.
1696:parml compact.
1697:pt.:link reftype=hd res=&HPM_WIN_CMD..Command:elink.
1698:pd.Show the command window.
1699:pt.:link reftype=hd res=&HPM_WIN_SRCS..Source files:elink.
1700:pd.Show the source files window.
1701:pt.:link reftype=hd res=&HPM_WIN_BRK..Breakpoints:elink.
1702:pd.Show the breakpoints window.
1703:pt.:link reftype=hd res=&HPM_WIN_DSP..Display:elink.
1704:pd.Show the display window.
1705:pt.:link reftype=hd res=&HPM_WIN_THR..Threads:elink.
1706:pd.Show the threads window.
1707:eparml.
1708
1709.************************************************************************
1710.* Keys help (register window)
1711.************************************************************************
1712:h1 res=&HELP_REG_KEYS..Keys help (register window)
1713:i1 id='reg.keys'.Keys (register window)
1714:lm margin=1.
1715:p.
1716You can use the following keys in the register window&colon.
1717:dl tsize=20 compact.
1718:edl.
1719:p.
1720Accelerator keys are missed out in the list above.
1721
1722.************************************************************************
1723.* PM debugging mode
1724.************************************************************************
1725:h1 res=&HPD_PMDEBUGMODE..Help for PM debugging mode dialog box
1726:i2 refid='pmgdb'.PM debugging mode dialog box
1727:lm margin=1.
1728:p.
1729Select the :hp8.Synchronous mode:ehp8. checkbox to enable
1730Synchronous mode. Synchronous mode is required for debugging PM
1731applications and must be selected before starting a PM application,
1732otherwise the Presentation Manager will hang, requiring a reboot to
1733recover. In Synchronous mode, only windows of :hp2.pmgdb:ehp2. and
1734of the program being debugged can be made active; all other windows
1735cannot be used. :hp2.pmgdb:ehp2. attempts to set Synchronous mode
1736automatically when a PM program is loaded.
1737
1738.************************************************************************
1739.* Line breakpoint
1740.************************************************************************
1741:h1 res=&HPD_BRKPT_LINE..Help for Line Breakpoint dialog box
1742:i2 refid='pmgdb'.Line Breakpoint dialog box
1743:lm margin=1.
1744:p.
1745This dialog box is used for adding or modifying a line breakpoint.
1746A line breakpoint is a breakpoint in a source line of the program.
1747:p.
1748Enter the name of the source file and the line number in that source file
1749in the :hp8.Source file:ehp8. and :hp8.Line:ehp8. fields, respectively.
1750:p.
1751A non-zero :hp8.Ignore count:ehp8. causes the breakpoint to not stop
1752the program until it has been reached this many times. If this
1753field is empty or contains zero, the program is stopped the first time
1754it reaches the breakpoint. Each time a breakpoint is reached, the ignore
1755count is decremented by one (unless it's already zero); if the ignore
1756count becomes zero (or was zero before), the breakpoint stops the program.
1757:p.
1758You can enter an expression in the :hp8.Condition:ehp8. field; that
1759expression will be evaluated each time the breakpoint is hit (unless
1760its ignore count is still non-zero); if it evaluates to false, the
1761breakpoint is ignored. That is, the breakpoint stops the program only
1762if the expression evaluates to true at the time the breakpoint is hit.
1763See the :hp2.GDB:ehp2. manual for details on expressions.
1764:p.
1765Breakpoints can be disabled by unchecking the :hp8.Enable:ehp8.
1766checkbox. Disabled breakpoints are ignored. Instead of deleting
1767breakpoints which you may need again later, you should disable them.
1768:p.
1769In the :hp8.Disposition:ehp8. field, you can select what to do with a
1770breakpoint when it stops the program&colon.
1771:dl tsize=20 compact.
1772:dt.&tt.del&ett.:dd.delete the breakpoint
1773:dt.&tt.dis&ett.:dd.disable the breakpoint
1774:dt.&tt.keep&ett.:dd.keep the breakpoint (default)
1775:edl.
1776:p.
1777This can be used to define temporary breakpoints.
1778
1779.************************************************************************
1780.* Startup
1781.************************************************************************
1782:h1 res=&HPD_STARTUP..Help for Startup dialog box
1783:i2 refid='pmgdb'.Startup dialog box
1784:lm margin=1.
1785:p.
1786This dialog box is used for setting startup options.
1787You can enter command line arguments for the debuggee
1788in the :hp8.Arguments:ehp8. field.
1789:p.
1790By default, the VIO window of the debuggee stays open after termination
1791of the debuggee, so that you can view the debuggee's output. You
1792have to close that window manually. If :hp8.Close window after exit:ehp8.
1793is checked, the VIO window will be closed automatically on termination
1794of the debuggee.
1795:p.
1796Use the :hp8.OK:ehp8. button to accept the settings, use the
1797:hp8.Run:ehp8. button to accept the settings and start the program.
1798If no breakpoints are set (or all breakpoints are disabled), a
1799breakpoint will be set on &tt.main&ett. if the :hp8.Run:ehp8. button
1800is selected.
1801
1802.************************************************************************
1803.* Display
1804.************************************************************************
1805:h1 res=&HPD_DISPLAY..Help for Display dialog box
1806:i2 refid='pmgdb'.Display dialog box
1807:lm margin=1.
1808:p.
1809This dialog box is used to add or modify a display.
1810:p.
1811Enter the expression to be displayed in the :hp8.Expression:ehp8.
1812field. See the :hp2.GDB:ehp2. manual for details on expressions.
1813:p.
1814Select a display format in the :hp8.Format:ehp8. field.
1815:p.
1816For some formats, the number of items to be displayed can be entered
1817in the :hp8.Count:ehp8. field.
1818:p.
1819Displays can be disabled by unchecking the :hp8.Enable:ehp8.
1820checkbox. The values of disabled displays are not displayed.
1821Instead of deleting displays which you may need again later, you should
1822disable them.
1823
1824.************************************************************************
1825.* Go to line
1826.************************************************************************
1827:h1 res=&HPD_GOTO..Help for Go to line dialog box
1828:i2 refid='pmgdb'.Go to line dialog box
1829:lm margin=1.
1830:p.
1831Enter a line number in the :hp8.Line:ehp8. field.
1832
1833.************************************************************************
1834.* Find
1835.************************************************************************
1836:h1 res=&HPD_FIND..Help for Find dialog box
1837:i2 refid='pmgdb'.Find dialog box
1838:lm margin=1.
1839:p.
1840Enter the regular expression to be searched for in the :hp8.Regexp:ehp8.
1841field.
1842
1843.************************************************************************
1844.* History
1845.************************************************************************
1846:h1 res=&HPD_HISTORY..Help for History dialog box
1847:i2 refid='pmgdb'.History dialog box
1848:lm margin=1.
1849:p.
1850In this dialog box, you can select and/or edit one of the commands
1851previously entered.
1852
1853.************************************************************************
1854.* Tutorial
1855.************************************************************************
1856:h1 res=&HELP_TUTORIAL..pmgdb tutorial
1857:i2 refid='pmgdb'.Tutorial
1858:i1 id='tut'.Tutorial
1859:lm margin=1.
1860:p.
1861:ol.
1862:li.If not already done, compile the &tt.sieve&ett. sample program
1863for debugging&colon.
1864:cgraphic.
1865cd \emx\samples
1866gcc -g sieve.c:ecgraphic.
1867:li.Start :hp2.pmgdb:ehp2. in the directory containing the source code
1868of the program to debug (debuggee). Specify the program and its command
1869line arguments on the command line of :hp2.pmgdb:ehp2.&colon.
1870:cgraphic.
1871cd \emx\samples
1872pmgdb sieve 100
1873:ecgraphic.
1874:p.
1875That is, just prepend &tt.pmgdb&ett. to the command line.
1876:li.:hp2.pmgdb:ehp2. will come up with two windows&colon.
1877the :link reftype=hd res=&HELP_CMD_WINDOW..command window:elink.,
1878titled `&tt.pmgdb - sieve&ett.', and the
1879:link reftype=hd res=&HELP_SRCS_WINDOW..Source files window:elink..
1880The command window shows :hp2.GDB:ehp2.'s welcome message and the
1881:hp2.GDB:ehp2. prompt. The Source Files window lists all the source
1882files of the debuggee. For this sample session, that's just
1883&tt.sieve.c&ett.. The source file which contains the &tt.main&ett.
1884function is highlighted (grey background). You can view a source
1885file by double clicking on a file name in the Source files window
1886(click on the file name, not on the blank space after the file name).
1887However we don't need to do this now.
1888:li.Run the program by selecting :link reftype=hd res=&HPM_GO..Go:elink.
1889from the :link reftype=hd res=&HPM_CMD_RUNMENU..Run menu:elink..
1890Note that the command window shows that a breakpoint has been hit&colon.
1891:cgraphic.
1892Breakpoint 1, main (argc=2, argv=0x282ffcc) at sieve.c&colon.76
1893:ecgraphic.
1894:p.
1895That breakpoint has been set automatically by :hp2.pmgdb:ehp2..
1896Moreover, a
1897:link reftype=hd res=&HELP_SRC_WINDOW..Source window:elink.
1898has popped up. The first executable line of the &tt.main&ett. function
1899has black background. The line where the debuggee has been stopped
1900is marked this way. Moreover, the line number has a red background; this
1901means that a breakpoint is set on that line.
1902:li.Now let's set a breakpoint on the &tt.isqrt&ett. function.
1903Either type
1904:cgraphic.
1905b isqrt
1906:ecgraphic.
1907:p.
1908in the command window or double click on the line number of line 45
1909(the first executable line of the function).
1910Let the program continue execution. (Remember? Go...)
1911:li.While stepping through &tt.isqrt&ett. we want to watch the
1912values of the variables &tt.l&ett., &tt.r&ett., and &tt.x&ett.
1913in :hp2.pmgdb:ehp2.'s
1914:link reftype=hd res=&HELP_DSP_WINDOW..Display window:elink..
1915This is done by double clicking on any instance of &tt.l&ett.,
1916&tt.r&ett., and &tt.x&ett. in the source code (:hp2.GDB:ehp2. uses
1917dynamic scoping, that is, it uses those variables which are visible at
1918the time the display is defined. Other debuggers use static scoping,
1919that is, they use the source code context in which the display
1920is defined.) The Display window should become visible automatically.
1921Move and/or resize the windows so that you can see both the Display
1922window and the source window. The two most important columns of
1923the Display window are :hp8.Expr:ehp8. (the expression being displayed,
1924for instance, a variable) and :hp8.Value:ehp8. (the value of the
1925expression). Note that the Display window
1926shows garbage for the &tt.l&ett. and &tt.r&ett. variables. This
1927is because these variables have not yet been initialized, so they
1928indeed contain garbage.
1929:li.Now let's execute some lines of C code (single step).
1930There are two operations for stepping lines of source code&colon.
1931:link reftype=hd res=&HPM_STEPOVER..Step over:elink.
1932and :link reftype=hd res=&HPM_STEPINTO..Step into:elink.,
1933both available in the
1934:link reftype=hd res=&HPM_CMD_RUNMENU..Run menu:elink..
1935The first one does not step into function calls, treating function
1936calls as one statement. The second one does step into function calls.
1937As &tt.isqrt&ett. does not call any functions, there's no difference
1938between the two here. Step over five lines of source code by hitting
1939the &tt.o&ett. key or &tt.i&ett. key five times while the source window
1940has the focus. Note how the values of &tt.l&ett. and &tt.r&ett. become valid.
1941:li.In addition to the three variables, we want to watch the value
1942of the expression `&tt.m*m&ett.'. Select
1943:link reftype=hd res=&HPM_DSP_ADD..Add:elink. from the
1944:link reftype=hd res=&HPM_SRC_DSPMENU..Display menu:elink.
1945and type `&tt.m*m&ett.' in the :hp8.Expression:ehp8. field
1946of the dialog box and hit Return or click the :hp8.OK:ehp8. button.
1947Note that the expression and its value have been added to the Display
1948window. You can also add displays by using :hp2.GDB:ehp2.'s &tt.display&ett.
1949command&colon.
1950:cgraphic.
1951disp m*m
1952:ecgraphic.
1953:p.
1954Continue stepping some (say, 20) source lines and watch the Display window.
1955:li.To let &tt.isqrt&ett. run to its end and stop at the place where
1956it has been called, select
1957:link reftype=hd res=&HPM_FINISH..Finish:elink. from the
1958:link reftype=hd res=&HPM_CMD_RUNMENU..Run menu:elink.
1959or hit the &tt.f&ett. key. The return value is displayed in
1960the command window. Note that the program is stopped in
1961the line containing the call to &tt.isqrt&ett., not on the line after.
1962This is because there's still some code of that line not yet executed.
1963As examining &tt.sqrt_size&ett. shows, the return value of &tt.isqrt&ett.
1964has not yet been assigned to that variable. If you don't want to
1965clutter the Display window with values which you want to examine only
1966once, use :hp2.GDB:ehp2.'s &tt.print&ett. command in the
1967command window&colon.
1968:cgraphic.
1969p sqrt_size
1970:ecgraphic.
1971:p.
1972Hit the &tt.o&ett. key to execute the rest of the code of that line.
1973:li.Now we want to trace through the code of &tt.main&ett. which
1974prints the result. That code starts at line 113. This time, we
1975don't set a breakpoint. Instead, select line 113 by clicking once
1976on the line number of that line. (You can scroll to an arbitrary line by
1977selecting :link reftype=hd res=&HPM_SRC_GOTO..Go to line:elink.
1978from the :link reftype=hd res=&HPM_SRC_VIEWMENU..View menu:elink.
1979and typing the line number.) Then, either select
1980:link reftype=hd res=&HPM_SRC_UNTIL..Until:elink. from the
1981:link reftype=hd res=&HPM_CMD_RUNMENU..Run menu:elink.
1982or hit the &tt.u&ett. key. This operations works by setting
1983a temporary breakpoint, which will vanish after completion of
1984the operation. Therefore, the line number does not have a red
1985background. This time, we do not want to step into functions
1986(such as &tt.printf&ett.), therefore use the &tt.o&ett. key
1987to step over the lines. If you're tired, hit the &tt.g&ett. key.
1988After stepping the last line, :hp2.GDB:ehp2. will say
1989:cgraphic.
1990Program exited normally.
1991:ecgraphic.
1992:p.
1993in the command window. Note that the window in which &tt.sieve.exe&ett.
1994was running won't go away automatically; the title changed
1995to
1996:cgraphic.
1997Completed&colon. sieve.exe
1998:ecgraphic.
1999:p.
2000and you have to close it manually. The application window will
2001be closed automatically if you select :hp8.Close window after exit:ehp8..
2002in the dialog box popped up by selecting
2003:link reftype=hd res=&HPM_CMD_STARTUP..Startup:elink.
2004from the :link reftype=hd res=&HPM_CMD_FILEMENU..File menu:elink.
2005before starting the program.
2006:eol.
2007
2008:euserdoc.
Note: See TracBrowser for help on using the repository browser.