Fixes: Doc - more documentation reviews/cleanups

RevBy: TrustMe
This commit is contained in:
Kavindra Palaraja
2008-12-02 13:06:53 +01:00
parent 1472bdb0cc
commit 7e3129f92c

View File

@@ -788,31 +788,31 @@
\table \table
\row \row
\i \bold{Note:} \i \bold{Note:}
\i Gdb, and therefore Qt Creator's debugger works for optimized builds
on Linux and Mac OS X. However, optimization may lead to re-ordering of \i Gdb, and therefore Qt Creator's debugger works for optimized
instructions or sometimes even complete removal of some local variables. builds on Linux and Mac OS X. However, optimization may lead
In this case, the \gui{Locals and Watchers} view may show unexpected data. to re-ordering of instructions or sometimes even complete
removal of some local variables. In this case, the
\gui{Locals and Watchers} view may show unexpected data.
\i The debug information provided by gcc does not include enough
information about the time when a variable is initialized.
Qt Creator therefore can not tell whether the contents of a
local variable contains "real data", or "initial noise". If a
QObject appears uninitialized, its value will be reported as
"out of scope". However, not all uninitialized objects can be
recognized as such.
\endtable \endtable
\note
\bold{Note:} The debug information provided by gcc does not include
enough information about the time at which a variable is initialized.
Qt Creator therefore can not tell whether the contents of a local
variable contains "real data", or "initial noise". If an QObject
appears uninitialized, its value will be reported as "out of scope".
Not all uninitialized objects can be recognized as such, though.
The \gui{Locals and Watchers View} also gives accesst to the most powerful The \gui{Locals and Watchers} view also provides access to the most
feature of the Qt Creator Debugger: The comprehensive display of data powerful feature of the debugger: comprehensive display of data belonging
of objects of some of Qt's basic classes. to Qt's basic objects. To enable this feature, select \gui{Use Custom
Display for Qt Objects} from the \gui Debug menu.The
To start using that feature, select \gui{Debug} and \gui{Use Custom \gui{Locals and Watchers} view will be re-organized to provide a high-level
Display for Qt Objects}. The \gui{Locals and Watchers View} will view of the objects. For example, in case of QObject, instead of displaying
be re-organized to give a more high-level view of the objects a pointer to some private data structure, you will see a list of children,
in question. So instead of displaying a pointer to some private signals and slots.
data structure in case of QObject, a list of children, signals
and slots will be shown.
Similarily, instead of showing a bunch of pointers and ints, Similarily, instead of showing a bunch of pointers and ints,
a QHash or QMap will display its contents in an orderly fashion, a QHash or QMap will display its contents in an orderly fashion,