summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEskil Abrahamsen Blomfeldt <eskil.abrahamsen-blomfeldt@digia.com>2012-12-07 09:59:47 +0100
committerThe Qt Project <gerrit-noreply@qt-project.org>2012-12-07 10:08:07 +0100
commit26de8567da8156a938492dc7d6df746a012dbda8 (patch)
tree9c82ab2c4b89e741a881c8e34231dd0ddde25bd4
parent2dd7e9648965e23ed19b49de288a2fd546f76566 (diff)
Write "Core Internals" overview in full sentences
Try to improve the readability of the overview by incorporating the links in sentences instead of listing them. Change-Id: Ia73dbc8173ddd35b8f5f41a61efb2798498a6f15 Reviewed-by: Paul Olav Tvete <paul.tvete@digia.com>
-rw-r--r--doc/src/core.qdoc66
1 files changed, 36 insertions, 30 deletions
diff --git a/doc/src/core.qdoc b/doc/src/core.qdoc
index 271b00411..6798ce8bb 100644
--- a/doc/src/core.qdoc
+++ b/doc/src/core.qdoc
@@ -38,17 +38,15 @@ functionality not already provided by Qt.
\section1 Objects, Properties and Events
-\list
-\li \l{The Event System}
-\li \l{Object Model}
-\li \l{The Meta-Object System}
-\li \l{The property system}
-\li \l{Signals & Slots}
-\li \l{Exposing Attributes of C++ Types to QML}{The meta-object in QML}
-\li \l{The State Machine Framework}
-\endlist
-
-
+The QObject class serves as the main class in Qt's \l{object model} and is used as a superclass
+of a great number of other Qt classes. It provides features such as a
+\l{The Meta-Object System}{meta-object system} which allows run-time introspection, manipulation
+and invocation of \l{The property system}{properties} and methods in the object. It also
+serves as the basis for Qt's \l{The Event System}{event system}, which is a low-level way of
+communicating between QObject-based objects. Another, more high-level form of communication is
+provided in Qt's \l{Signals & Slots} mechanism. These features can also be used in combination
+with \l{The State Machine Framework} which provides a formally defined and predictable way of
+managing the states of your application.
\section1 Container Classes
@@ -58,34 +56,42 @@ lists, and associative arrays. Qt provides a set of general purpose,
template-based container classes that can be used to store data in memory.
See the full list of \l {Container Classes} for more details.
-
\section1 Internationalization
-\list
-\li \l{Unicode in Qt}
-\li \l{Internationalization with Qt}
-\endlist
+Qt uses \l{Unicode in Qt}{unicode} for the encoding of displayable text strings in order to provide
+support for all commonly used writing systems in the world. Applications can also be written
+to support any number of different languages with one code base using Qt's powerful
+\l{Internationalization with Qt}{internationalization system}.
\section1 Inter-Process Communication
-\list
-\li \l{Inter-Process Communication in Qt}
-\li \l{QProcess}
-\endlist
+Qt provides several classes to support
+\l{Inter-Process Communication in Qt}{communication between processes}. You can also launch
+and manage external processes using the \l{QProcess} class.
\section1 Threading
-\list
-\li \l{Thread Support in Qt}
-\li \l{Threading Basics}
-\endlist
+Qt supports \l{Thread Support in Qt}{primitives and convenience functionality} to manage
+\l{Threading Basics}{threads and parallelize code} in a safe and platform-independent way.
\section1 Platform Support
-\list
-\li \l{Qt Platform Abstraction}
-\li \l{Wayland Support in Qt}{Wayland}
-\li \l{Cross-Platform and Platform-Specific Development}
-\li \l{How to Create Qt Plugins}
-\endlist
+Qt allows you to write platform-independent code, where the same code base can be compiled
+for and deployed on different platforms without any changes. In cases where you need to use
+platform-specific features and integrate with system libraries, Qt also provides solutions
+for this.
+\l{Cross-Platform and Platform-Specific Development}{Our guide to cross-platform development}
+provides information on writing software on different platforms.
+
+Qt integrates with the windowing system on the target platform using the
+\l{Qt Platform Abstraction}. This is an abstraction of the windowing system which
+makes porting Qt to new platforms simple and quick. One such system is the
+Wayland protocol. \l{Wayland Support in Qt}{Qt supports Wayland}, which e.g. can be used to set up
+a light-weight windowing system on embedded hardware to support a multi-process graphical user
+interface.
+
+The Qt Platform Abstraction uses \l{How to Create Qt Plugins}{Qt's plugin system}. This system
+provides APIs to extend Qt in specific areas (such as adding support for new image formats, database
+drivers, etc.) and also for writing your own extensible Qt applications which support third-party
+plugins.
*/