summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJason Barron <jbarron@trolltech.com>2009-08-21 12:39:29 (GMT)
committerJason Barron <jbarron@trolltech.com>2009-08-21 12:39:29 (GMT)
commite59ee48a8656d04339967ad99334bd0ddca0c956 (patch)
tree4fe72429115ae4a4171cd3f1f06d9a3a425973d0 /doc
parent4aa6869877d4906fcfaac5388294748512cace25 (diff)
parent508b447075fb852e61ddf88c92c9099dad292747 (diff)
downloadQt-e59ee48a8656d04339967ad99334bd0ddca0c956.zip
Qt-e59ee48a8656d04339967ad99334bd0ddca0c956.tar.gz
Qt-e59ee48a8656d04339967ad99334bd0ddca0c956.tar.bz2
Merge commit 'qt/master'
Diffstat (limited to 'doc')
-rw-r--r--doc/doc.pri4
-rw-r--r--doc/src/classes.qdoc123
-rw-r--r--doc/src/classes/exportedfunctions.qdoc6
-rw-r--r--doc/src/index.qdoc2
-rw-r--r--doc/src/legal/commercialeditions.qdoc12
-rw-r--r--doc/src/modules.qdoc52
-rw-r--r--doc/src/platforms/winsystem.qdoc4
7 files changed, 115 insertions, 88 deletions
diff --git a/doc/doc.pri b/doc/doc.pri
index 13d481f..66953e6 100644
--- a/doc/doc.pri
+++ b/doc/doc.pri
@@ -14,9 +14,9 @@ win32:!win32-g++ {
}
$$unixstyle {
- QDOC = cd $$QT_SOURCE_TREE/tools/qdoc3/test && QT_BUILD_TREE=$$QT_BUILD_TREE QT_SOURCE_TREE=$$QT_SOURCE_TREE $$QT_BUILD_TREE/tools/qdoc3/qdoc3 $$DOCS_GENERATION_DEFINES
+ QDOC = cd $$QT_SOURCE_TREE/tools/qdoc3/test && QT_BUILD_TREE=$$QT_BUILD_TREE QT_SOURCE_TREE=$$QT_SOURCE_TREE $$QT_BUILD_TREE/bin/qdoc3 $$DOCS_GENERATION_DEFINES
} else {
- QDOC = cd $$QT_SOURCE_TREE/tools/qdoc3/test && set QT_BUILD_TREE=$$QT_BUILD_TREE&& set QT_SOURCE_TREE=$$QT_SOURCE_TREE&& $$QT_BUILD_TREE/tools/qdoc3/qdoc3.exe $$DOCS_GENERATION_DEFINES
+ QDOC = cd $$QT_SOURCE_TREE/tools/qdoc3/test && set QT_BUILD_TREE=$$QT_BUILD_TREE&& set QT_SOURCE_TREE=$$QT_SOURCE_TREE&& $$QT_BUILD_TREE/bin/qdoc3.exe $$DOCS_GENERATION_DEFINES
QDOC = $$replace(QDOC, "/", "\\")
}
macx {
diff --git a/doc/src/classes.qdoc b/doc/src/classes.qdoc
index 864445f..24acce1 100644
--- a/doc/src/classes.qdoc
+++ b/doc/src/classes.qdoc
@@ -41,58 +41,85 @@
/*!
\group classlists
- \title Class and Function Indexes
- \brief Collections of classes and functions grouped together into lists.
+ \title Class and Function Documentation
+ \brief Lists and Indexes of classes, functions, and types.
- The following documents contain collections of classes, grouped by
- subject area or related to particular functionality, or comprehensive
- lists of classes and functions.
+ Links to indexes and lists for finding class and function
+ reference documentation.
+
+ \section2 Class Lists
+
+ \annotatedlist classlists
+
+ \section2 Function Lists
+
+ \annotatedlist funclists
- \generatelist{related}
*/
/*!
- \group groups
- \title Grouped Classes
+ \page classes.html
+ \title All Qt Classes (main index)
\ingroup classlists
- This page provides a way of navigating Qt's classes by grouping
- related classes together. Some classes may appear in more than one group.
+ \brief If you know the name of the class you want, find it here.
- \generatelist{related}
+ This is a list of all Qt classes. For a list of the classes
+ provided for compatibility with Qt3, see \l{Qt3 Support
+ Classes}. For classes that have been deprecated, see the
+ \l{Obsolete Classes} list.
+
+ \generatelist classes
+ \sa {Qt3 Support Classes}, {All Qt Modules}, {Obsolete Classes}
*/
/*!
- \page classes.html
- \title Qt's Classes
+ \page annotated.html
+ \title Annotated Class List
\ingroup classlists
- This is a list of all Qt classes. For a list of the classes provided
- for compatibility with Qt3, see \l{Qt 3 compatibility classes}. For
- classes that have been deprecated, see the \l{Obsolete Classes} list.
+ \brief If you don't know the name of the class you want, but you
+ know what the class should do, you might try looking here.
- \generatelist classes
+ Qt classes with brief descriptions:
- \sa {Qt 3 Compatibility Classes}, {Qt's Modules}, {Obsolete Classes}
+ \generatelist annotatedclasses
*/
/*!
- \page namespaces.html
- \title Qt's Namespaces
+ \group groups
+ \title Groups Of Related Classes
\ingroup classlists
- This is a list of the main namespaces in Qt. For a list of classes in
- Qt, see \l{Qt's Classes}.
+ \brief If you know what kind of class you want (GUI, painting,
+ I.O, etc), look here.
- \generatelist{namespaces}
+ This is a list of functional groups of Qt classes. A class can
+ appear in more than one functional group.
+
+ \generatelist{related}
+
+*/
+
+/*!
+ \page hierarchy.html
+
+ \title Inheritance Hierarchy
+ \ingroup classlists
+
+ \brief The C++ class inheritance hierarchy for all classes in the
+ Qt API.
+
+ \generatelist classhierarchy
*/
/*!
\page obsoleteclasses.html
\title Obsolete Classes
\ingroup classlists
-
+
+ \brief These classes are obsolete and should not be used in new code.
This is a list of Qt classes that are obsolete (deprecated). These
classes are provided to keep old source code working but they are
@@ -101,52 +128,46 @@
\generatelist obsoleteclasses
- \sa {Qt's Classes}, {Qt's Modules}
*/
/*!
- \page annotated.html
- \title Annotated Class Index
+ \page compatclasses.html
+ \title Qt3 Support Classes
\ingroup classlists
- Qt's classes with brief descriptions:
+ \brief These classes ease the porting of code from Qt 3 to Qt 4.
- \generatelist annotatedclasses
-*/
-
-/*!
- \page functions.html
- \title Member Function Index
- \ingroup classlists
+ These are the classes that Qt provides for compatibility with Qt
+ 3. Most of these are provided by the Qt3Support module.
- Here is the list of all the documented member functions in the Qt
- API with links to the class documentation for each function.
+ \generatelist compatclasses
- \generatelist functionindex
*/
/*!
- \page hierarchy.html
+ \page functions.html
+ \title All Functions (main index)
+ \ingroup funclists
- \title Class Inheritance Hierarchy
- \ingroup classlists
+ \brief All documented Qt functions listed alphabetically with a
+ link to where each one is declared.
- This list shows the C++ class inheritance relations between the
- classes in the Qt API.
+ This is the list of all documented member functions and global
+ functions in the Qt API. Each function has a link to the class or
+ header file where it is declared and documented.
- \generatelist classhierarchy
+ \generatelist functionindex
*/
+
/*!
- \page compatclasses.html
- \title Qt 3 Compatibility Classes
+ \page namespaces.html
+ \title All Qt Namespaces
\ingroup classlists
- This is a list of the classes that Qt provides for compatibility
- with Qt 3. The vast majority of these are provided by the
- Qt3Support module.
+ \brief A Qt namespace contains enum types, functions, and sometimes classes.
- \generatelist compatclasses
+ This is a list of the main namespaces in Qt.
- \sa {Qt's Classes}, {Qt's Modules}
+ \generatelist{namespaces}
*/
diff --git a/doc/src/classes/exportedfunctions.qdoc b/doc/src/classes/exportedfunctions.qdoc
index c51ace4..a0e3904 100644
--- a/doc/src/classes/exportedfunctions.qdoc
+++ b/doc/src/classes/exportedfunctions.qdoc
@@ -41,8 +41,10 @@
/*!
\page exportedfunctions.html
- \title Special-Purpose Global Functions Exported by Qt
- \ingroup classlists
+ \title Platform-Specific Functions
+ \ingroup funclists
+
+ \brief Exported functions for fine tuning Qt applications.
Qt provides a few low-level global functions for fine-tuning
applications. Most of these perform very specific tasks and are
diff --git a/doc/src/index.qdoc b/doc/src/index.qdoc
index b0695b8..4d92157 100644
--- a/doc/src/index.qdoc
+++ b/doc/src/index.qdoc
@@ -81,7 +81,7 @@
</td>
<td valign="top">
<ul>
- <li><a href="classlists.html">C++ Class Documentation</a></li>
+ <li><a href="classlists.html">Class and Function Documentation</a></li>
<li><a href="frameworks-technologies.html">Frameworks and Technologies</a></li>
<li><a href="best-practices.html">How-To&#39;s and Best Practices</a></li>
</ul>
diff --git a/doc/src/legal/commercialeditions.qdoc b/doc/src/legal/commercialeditions.qdoc
index 761a53b..93dc194 100644
--- a/doc/src/legal/commercialeditions.qdoc
+++ b/doc/src/legal/commercialeditions.qdoc
@@ -91,8 +91,8 @@
following pages:
\list
- \o \l{Qt GUI Framework Edition Classes}
- \o \l{Qt Full Framework Edition Classes}
+ \o \l{Qt GUI Framework Edition}
+ \o \l{Qt Full Framework Edition}
\endlist
Please see the \l{Supported Platforms}{list of supported
@@ -119,16 +119,20 @@
/*!
\page full-framework-edition-classes.html
- \title Qt Full Framework Edition Classes
+ \title Qt Full Framework Edition
\ingroup classlists
+ \brief The list of Qt classes included in the Full Framework Edition.
+
\generatelist{classesbyedition Desktop}
*/
/*!
\page gui-framework-edition-classes.html
- \title Qt GUI Framework Edition Classes
+ \title Qt GUI Framework Edition
\ingroup classlists
+ \brief The list of Qt classes included in the GUI Framework Edition.
+
\generatelist{classesbyedition DesktopLight}
*/
diff --git a/doc/src/modules.qdoc b/doc/src/modules.qdoc
index 2fc6eaf..786122e 100644
--- a/doc/src/modules.qdoc
+++ b/doc/src/modules.qdoc
@@ -41,14 +41,14 @@
/*!
\group modules
- \title Qt's Modules
+ \title All Qt Modules
\startpage index.html Qt Reference Documentation
\nextpage QtCore
\ingroup classlists
- Qt 4 consists of several modules, each of which lives in a
- separate library.
+ \brief Qt 4 comprises several modules. Each module is a separate
+ library.
\table 80%
\header \o {2,1} \bold{Modules for general software development}
@@ -89,14 +89,14 @@
or other build tools such as CMake, you also need to link against
the \c qtmain library.
- \sa {Qt's Classes}
+ \sa {Class and Function Documentation}
*/
/*!
\module QtCore
\title QtCore Module
- \contentspage Qt's Modules
- \previouspage Qt's Modules
+ \contentspage All Qt Modules
+ \previouspage All Qt Modules
\nextpage QtGui
\ingroup modules
@@ -116,7 +116,7 @@
/*!
\module QtGui
\title QtGui Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtCore
\nextpage QtNetwork
\ingroup modules
@@ -135,7 +135,7 @@
/*!
\module QtMultimedia
\title QtMultimedia Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtCore
\nextpage QtNetwork
\ingroup modules
@@ -159,7 +159,7 @@
/*!
\module QtNetwork
\title QtNetwork Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtMultimedia
\nextpage QtOpenGL
\ingroup modules
@@ -184,7 +184,7 @@
/*!
\module QtOpenGL
\title QtOpenGL Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtNetwork
\nextpage QtOpenVG
\ingroup modules
@@ -236,7 +236,7 @@
\module QtOpenVG
\title QtOpenVG Module
\since 4.6
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtOpenGL
\nextpage QtScript
\ingroup modules
@@ -291,7 +291,7 @@
\module QtScript
\title QtScript Module
\since 4.3
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtOpenVG
\nextpage QtScriptTools
\ingroup modules
@@ -321,7 +321,7 @@
\module QtScriptTools
\title QtScriptTools Module
\since 4.5
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtScript
\nextpage QtSql
\ingroup modules
@@ -350,7 +350,7 @@
/*!
\module QtSql
\title QtSql Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtScript
\nextpage QtSvg
\ingroup modules
@@ -373,7 +373,7 @@
\module QtSvg
\title QtSvg Module
\since 4.1
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtSql
\nextpage QtWebKit
\ingroup modules
@@ -428,7 +428,7 @@
/*!
\module QtXml
\title QtXml Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtSvg
\nextpage QtXmlPatterns
\ingroup modules
@@ -458,7 +458,7 @@
\module QtXmlPatterns
\title QtXmlPatterns Module
\since 4.4
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtXml
\nextpage Phonon Module
\ingroup modules
@@ -533,7 +533,7 @@
\page phonon-module.html
\module Phonon
\title Phonon Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtXmlPatterns
\nextpage Qt3Support
\ingroup modules
@@ -604,7 +604,7 @@
/*!
\module Qt3Support
\title Qt3Support Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage Phonon Module
\nextpage QtDesigner
\ingroup modules
@@ -645,7 +645,7 @@
/*!
\module QtDesigner
\title QtDesigner Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage Qt3Support
\nextpage QtUiTools
\ingroup modules
@@ -676,7 +676,7 @@
\module QtUiTools
\title QtUiTools Module
\since 4.1
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtDesigner
\nextpage QtHelp
\ingroup modules
@@ -716,7 +716,7 @@
/*!
\module QtHelp
\title QtHelp Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtUiTools
\nextpage QtTest
\ingroup modules
@@ -779,7 +779,7 @@
/*!
\module QtTest
\title QtTest Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtHelp
\nextpage QAxContainer
\ingroup modules
@@ -809,7 +809,7 @@
/*!
\module QAxContainer
\title QAxContainer Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QtTest
\nextpage QAxServer
\ingroup modules
@@ -859,7 +859,7 @@
/*!
\module QAxServer
\title QAxServer Module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QAxContainer
\nextpage QtDBus module
\ingroup modules
@@ -909,7 +909,7 @@
/*!
\module QtDBus
\title QtDBus module
- \contentspage Qt's Modules
+ \contentspage All Qt Modules
\previouspage QAxServer
\ingroup modules
diff --git a/doc/src/platforms/winsystem.qdoc b/doc/src/platforms/winsystem.qdoc
index 5afa1f7..c20973b 100644
--- a/doc/src/platforms/winsystem.qdoc
+++ b/doc/src/platforms/winsystem.qdoc
@@ -51,8 +51,8 @@
appropriate \c{#ifdef} directives (see below).
Qt provides a few low-level global functions for fine-tuning
- applications on specific platforms. See \l{Special-Purpose Global
- Functions Exported by Qt} for details.
+ applications on specific platforms. See \l{Platform-Specific
+ Functions} for details.
\tableofcontents