OSDN Git Service

debugger: change "watchpoint" to "data breakpoint" also in the class docs
authorhjk <qtc-committer@nokia.com>
Mon, 16 May 2011 10:37:04 +0000 (12:37 +0200)
committerhjk <qtc-committer@nokia.com>
Mon, 16 May 2011 10:39:18 +0000 (12:39 +0200)
doc/qtcreator.qdoc
src/plugins/debugger/breakpoint.h

index 7d6878f..4252246 100644 (file)
         \o Retrieves data representing the call stack at the program's current
            position.
         \o Retrieves the contents of local variables.
-        \o Examines \gui Watchers.
+        \o Examines \gui Expressions.
         \o Updates the \gui Registers, \gui Modules, and \gui Disassembler
            views if you are debugging the C++ based applications.
     \endlist
 
     \endlist
 
-    If the address is displayed in the \gui {Locals and Watchers} view, you can
+    If the address is displayed in the \gui {Locals and Expressions} view, you can
     select \gui {Add Watchpoint at Object's Address} in the context menu to set
     the watchpoint.
 
     corresponding source locations are grayed out in the \gui{Stack} view.
 
     If you click a frame with a known source location, the text editor
-    jumps to the corresponding location and updates the \gui{Locals and Watchers}
+    jumps to the corresponding location and updates the \gui{Locals and Expressions}
     view, making it seem like the program was interrupted before entering the
     function.
 
-    \section1 Locals and Watchers
+    \section1 Locals and Expressions
 
     Whenever a program stops under the control of the debugger, it retrieves
     information about the topmost stack frame and displays it in the
-    \gui{Locals and Watchers} view. The \gui{Locals and Watchers} view
+    \gui{Locals and Expressions} view. The \gui{Locals and Expressions} view
     typically includes information about parameters of the function in that
     frame as well as the local variables.
 
-    \image qtcreator-watcher.png "Locals and Watchers view"
+    \image qtcreator-watcher.png "Locals and Expressions view"
 
     Compound variables of struct or class type are displayed as
     expandable in the view. Expand entries to show
             \i  GDB, and therefore Qt Creator's debugger works for optimized
                 builds on Linux and Mac OS X. Optimization can lead to
                 re-ordering of instructions or removal of some local variables,
-                causing the \gui{Locals and Watchers} view to show unexpected
+                causing the \gui{Locals and Expressions} view to show unexpected
                 data.
         \row
             \i  The debug information provided by GCC does not include enough
     \endtable
 
 
-    The \gui{Locals and Watchers} view also provides access to the most
+    The \gui{Locals and Expressions} view also provides access to the most
     powerful feature of the debugger: comprehensive display of data belonging
     to Qt's basic objects.
 
        \o  Select \gui Tools > \gui {Options...} > \gui Debugger >
            \gui{Debugging Helper} and check the \gui{Use Debugging Helper}
            checkbox.
-       \o  The \gui{Locals and Watchers} view is reorganized to provide a
+       \o  The \gui{Locals and Expressions} view is reorganized to provide a
            high-level view of the objects.
     \endlist
 
     Also, the debugger displays access data for QFileInfo and provides
     access to the "real" contents of QVariant.
 
-    You can use the \gui{Locals and Watchers} view to change the contents of
+    You can use the \gui{Locals and Expressions} view to change the contents of
     variables of simple data types, for example, \c int or \c float when the
     program is interrupted. To do so, click the \gui Value column, modify
     the value with the inplace editor, and press \key Enter (or \key Return).
     \note Usually, you do not need this feature, because Qt Creator provides
     you with better ways to handle the task. For example, instead of using the
     GDB \c print command from the command line, you can create a watcher item
-    in the \gui{Locals and Watchers} view and examine the expression there.
+    in the \gui{Locals and Expressions} view and examine the expression there.
 
     \section1 Debugging C++ Based Applications
 
 
 
         \o To view the contents of \c{line}, go to the \gui{Locals and
-    Watchers} view.
+    Expressions} view.
 
         \image qtcreator-watcher.png
 
     \section1 Debugging Helpers Based on Python
 
     Qt Creator uses GDB builds that enable Python scripting to display
-    information in the \gui {Locals and Watchers} view. When Python scripting
+    information in the \gui {Locals and Expressions} view. When Python scripting
     is used, code (Debugging helpers) does not need to be injected into the
     debugged process to nicely display QStringList or \c std::map contents, for
     example.
 
     The function has to feed the Dumper object with certain information
     which is used to build up the object and its children's display in the
-    \gui{Locals and Watchers} view.
+    \gui{Locals and Expressions} view.
 
 
     Example:
     \section2 Item Class
 
     The Item Python class is a thin wrapper around values corresponding to one
-    line in the \gui{Locals and Watchers} view. The Item members are as follows :
+    line in the \gui{Locals and Expressions} view. The Item members are as follows :
 
     \list
 
 
     \section2 Dumper Class
 
-    For each line in the \gui{Locals and Watchers} view, a string like the
+    For each line in the \gui{Locals and Expressions} view, a string like the
     following needs to be created and channeled to the debugger plugin.
     \code
     "{iname='some internal name',
 
         \o \l{Viewing Call Stack Trace}
 
-        \o \l{Locals and Watchers}
+        \o \l{Locals and Expressions}
 
     \endlist
 
     Qt's signals and slots mechanism, select \gui Tools > \gui Options...
     > \gui{Debugger} > \gui{Debugging Helper} > \gui{Use Debugging Helper}.
 
-    In the \gui{Locals and Watchers} view, expand the object's entry and open
+    In the \gui{Locals and Expressions} view, expand the object's entry and open
     the slot in the \e slots subitem. The objects connected to this slot are
     shown as children of the slot. This method works with signals too.
 
-    For more information about the \gui{Locals and Watchers} view, see
-    \l{Locals and Watchers}.
+    For more information about the \gui{Locals and Expressions} view, see
+    \l{Locals and Expressions}.
 
 
     \section1 Displaying Low Level Data
 
     Pinned tooltips are stored in the session. To close all pinned tooltips,
     select \gui {Close Editor Tooltips} in the context menu in the \gui {Locals
-    and Watchers} view.
+    and Expressions} view.
 
 
     \section1 Locating Files
 
         \o When debugging executables created by the GNU Compiler version 4.5.0
            (all platforms), some data types will not be displayed in the
-           \gui{Locals and Watchers} view due to missing debug information.
+           \gui{Locals and Expressions} view due to missing debug information.
 
         \o GDB on Windows may not work if the 'Embassy \reg Security Center' software
            by 'Wave \reg Systems' is installed and active (causing crashes in \c{vxvault.dll)}).
 
     \section1 Pointer Variable Members Are Not Displayed Directly
 
-    When you use the \gui {Locals and Watchers} view to inspect a pointer
+    When you use the \gui {Locals and Expressions} view to inspect a pointer
     variable and expand the variable tree item, another tree item level
     is displayed. To directly display the members of the pointer variable,
     select \gui {Dereference Pointers Automatically} in the context menu in the
-    \gui {Locals and Watchers} view.
+    \gui {Locals and Expressions} view.
 
     \section1 Built-in Debugger Is Slow During Startup and Runtime
 
index d0d5e71..c922684 100644 (file)
@@ -143,9 +143,9 @@ public:
     QByteArray condition;    //!< Condition associated with breakpoint.
     int ignoreCount;         //!< Ignore count associated with breakpoint.
     int lineNumber;          //!< Line in source file.
-    quint64 address;         //!< Address for address based watchpoints.
-    QString expression;      //!< Expression for expression based watchpoints.
-    uint size;               //!< Size of watched area for watchpoints.
+    quint64 address;         //!< Address for address based data breakpoints.
+    QString expression;      //!< Expression for expression based data breakpoints.
+    uint size;               //!< Size of watched area for data breakpoints.
     uint bitpos;             //!< Location of watched bitfield within watched area.
     uint bitsize;            //!< Size of watched bitfield within watched area.
     int threadSpec;          //!< Thread specification.