gdb/gdbtk/library/help/breakpoint.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
   2 <HTML>
   3 <HEAD>
   4    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
   5    <META NAME="GENERATOR" CONTENT="Mozilla/4.06 [en] (X11; I; Linux 2.0.35 i686) [Netscape]">
   6    <TITLE>Breakpoint Window Help</TITLE>
   7 </HEAD>
   8 <BODY>
   9
  10 <H1>The Breakpoint Window</H1>
  11 The Breakpoint Window lists all the various breakpoints that exist in the
  12 program. It facilitates modifying breakpoints (make them temporary or normal,
  13 disabled or enabled) and removing breakpoints.
  14 <UL>
  15 <LI><A HREF="#menus_bp">Breakpoint Menu</A></LI>
  16 <LI><A HREF="#menus_global">Global Menu</A></LI>
  17 <LI><A HREF="#display">Breakpoint Display</A></LI>
  18 </UL>
  19
  20 <HR SIZE=4 WIDTH="100%">
  21
  22 <H2>
  23 <A NAME="menus_bp"></A>Breakpoint Menu</H2>
  24 The Breakpoint Menu operates on the selected breakpoint only.&nbsp; If
  25 no breakpoint is selected the menu items will be disabled. The type and
  26 state of a breakpoint may be changed by selecting the desired type or state
  27 from the menu.
  28 <DL>
  29 <DT>Normal</DT>
  30 <DD>The selected breakpoint is a normal breakpoint</DD>
  31 <DT>Temporary</DT>
  32 <DD>Indicates that the breakpoint is temporary</DD>
  33 <DT>Enabled</DT>
  34 <DD>The breakpoint is active and will stop the debugger when it is hit.</DD>
  35 <DT>Disabled</DT>
  36 <DD>The breakpoint is being ignored. A disabled breakpoint will never get hit.</DD>
  37 <DT>Remove</DT>
  38 <DD>Deletes the breakpoint</DD>
  39 </DL>
  40
  41 <HR SIZE=4 WIDTH="100%">
  42 <H2>
  43 <A NAME="menus_global"></A>Global Menu</H2>
  44 Items on the Global Menu affect all defined breakpoints. Users may:
  45 <DL>
  46 <DT>Show Threads</DT>
  47 <DD>Toggle on/off the thread column</DD>
  48 <DT>Enable All</DT>
  49 <DD>Enable all breakpoints</DD>
  50 <DT>Disable All</DT>
  51 <DD>Disable all breakpoints</DD>
  52 <DT>Remove All</DT>
  53 <DD>Delete all breakpoints</DD>
  54 </DL>
  55
  56 <HR SIZE=4 WIDTH="100%">
  57
  58 <H2><A NAME="display"></A>Breakpoint Display</H2>
  59 The Breakpoint Display is a table of breakpoints. The first column of the
  60 table (unlabeled) shows a checkbutton, indicating whether the breakpoint
  61 is enabled (checked) or disabled (unchecked). Disabled breakpoints are
  62 ignored and will not cause the program to stop.
  63 <P>To use the Breakpoint Menu or the Breakpoint Pop-up Menu, first use
  64 the left mouse button to select a breakpoint from the list, then make the
  65 menu selection.
  66
  67 <H4>Modifying Breakpoints</H4>
  68 To&nbsp;<A NAME="display_state"></A>enable a breakpoint, simply click the
  69 checkbutton in the first column of the desired breakpoint so that it is
  70 selected (checked). To disable a breakpoint, "uncheck" the checkbutton.
  71 <P>To change a breakpoint's&nbsp;<A NAME="display_temp"></A>type, select
  72 the desired type from either the Breakpoint Menu or the Breakpoint Pop-up
  73 Menu.
  74 <P>To remove a&nbsp;<A NAME="display_remove"></A>breakpoint, use the left
  75 mouse button to select the breakpoint to remove and use either the Breakpoint
  76 Menu or the Breakpoint Pop-up Menu to select "remove". To re-install a
  77 breakpoint, use the <A HREF="source.html#setting_a_breakpoint">Source Window
  78 Display</A>.
  79
  80 <H4><A NAME="display_popup"></A>Breakpoint Pop-up Menu</H4>
  81 The Breakpoint Pop-up Menu is accessed by using the mouse cursor to select
  82 a breakpoint from the Breakpoint Display and then clicking the right button
  83 on the mouse. The Pop-up allows expert users quicker access to the functions
  84 of the Breakpoint Menu:
  85 <DL>
  86 <DT>Normal</DT>
  87 <DD>The selected breakpoint is a normal breakpoint</DD>
  88 <DT>Temporary</DT>
  89 <DD>Indicates that the breakpoint is temporary</DD>
  90 <DT>Enabled</DT>
  91 <DD>The breakpoint is active and will stop the debugger when it is hit.</DD>
  92 <DT>Disabled</DT>
  93 <DD>The breakpoint is being ignored. A disabled breakpoint will never get hit.</DD>
  94 <DT>Remove</DT>
  95 <DD>Deletes the breakpoint</DD>
  96 <DT>Global, Show Threads</DT>
  97 <DD>Toggle on/off the thread column</DD>
  98 <DT>Global, Enable All</DT>
  99 <DD>Enable all breakpoints</DD>
 100 <DT>Global, Disable All</DT>
 101 <DD>Disable all breakpoints</DD>
 102 <DT>Global, Remove All</DT>
 103 <DD>Delete all breakpoints</DD>
 104 </DL>
 105
 106 </BODY>
 107 </HTML>