QtCore: remove \link usages

Change-Id: I0de764b51a972de0b6eb2bf3c04d2b190f581f52
Reviewed-by: Casper van Donderen <casper.vandonderen@nokia.com>

src/corelib/codecs/codecs.qdoc

@@ -346,9 +346,9 @@
 
     The environment variable \c UNICODEMAP_JP can be used to
     fine-tune the JIS, Shift-JIS, and EUC-JP codecs. The mapping
-    names are as for the Japanese XML working group's \link
+    names are as for the Japanese XML working group's
-    http://www.y-adagio.com/public/standards/tr_xml_jpf/toc.htm XML
+    \l{XML Japanese Profile},
-    Japanese Profile\endlink, because it names and explains all the
+    because it names and explains all the
     widely used mappings. Here are brief descriptions, written by
     Serika Kurusugawa:
 
@@ -486,11 +486,10 @@
     TSCII, formally the Tamil Standard Code Information Interchange
     specification, is a commonly used charset for Tamils. The
     official page for the standard is at
-    \link http://www.tamil.net/tscii/ http://www.tamil.net/tscii/\endlink
+    \l{http://www.tamil.net/tscii/}
 
     This codec uses the mapping table found at
-    \link http://www.geocities.com/Athens/5180/tsciiset.html
+    \l{http://www.geocities.com/Athens/5180/tsciiset.html}.
-    http://www.geocities.com/Athens/5180/tsciiset.html\endlink.
     Tamil uses composed Unicode which might cause some
     problems if you are using Unicode fonts instead of TSCII fonts.
 

src/corelib/codecs/qtextcodec.cpp

@@ -977,8 +977,8 @@ QTextCodec *QTextCodec::codecForName(const QByteArray &name)
 
 
 /*!
-    Returns the QTextCodec which matches the \link
+    Returns the QTextCodec which matches the
-    QTextCodec::mibEnum() MIBenum\endlink \a mib.
+    \l{QTextCodec::mibEnum()}{MIBenum} \a mib.
 */
 QTextCodec* QTextCodec::codecForMib(int mib)
 {

src/corelib/doc/src/external-resources.qdoc

@@ -0,0 +1,42 @@
+/****************************************************************************
+**
+** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:FDL$
+** GNU Free Documentation License
+** Alternatively, this file may be used under the terms of the GNU Free
+** Documentation License version 1.3 as published by the Free Software
+** Foundation and appearing in the file included in the packaging of
+** this file.
+**
+** Other Usage
+** Alternatively, this file may be used in accordance with the terms
+** and conditions contained in a signed written agreement between you
+** and Nokia.
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+
+/*!
+    \externalpage http://www.y-adagio.com/public/standards/tr_xml_jpf/toc.htm
+    \title XML Japanese Profile
+*/
+
+/*!
+    \externalpage http://www.geocities.com/Athens/5180/tsciiset.html
+    \title http://www.geocities.com/Athens/5180/tsciiset.html
+*/
+
+/*!
+    \externalpage http://www.tamil.net/tscii/
+    \title http://www.tamil.net/tscii/
+*/

src/corelib/doc/src/objectmodel/objecttrees.qdoc

@@ -34,9 +34,9 @@
 
     \section1 Overview
 
-    \link QObject QObjects\endlink organize themselves in object trees.
+    \l{QObject}{QObjects} organize themselves in object trees.
     When you create a QObject with another object as parent, it's added to
-    the parent's \link QObject::children() children() \endlink list, and
+    the parent's \l{QObject::children()}{children()} list, and
     is deleted when the parent is. It turns out that this approach fits
     the needs of GUI objects very well. For example, a \l QShortcut
     (keyboard shortcut) is a child of the relevant window, so when the

src/corelib/doc/src/objectmodel/signalsandslots.qdoc

@@ -272,9 +272,9 @@
     and slot members, as well as pointers to these functions.
 
     The meta-object contains additional information such as the
-    object's \link QObject::className() class name\endlink. You can
+    object's \l{QObject::className()}{class name}. You can
-    also check if an object \link QObject::inherits()
+    also check if an object \l{QObject::inherits()}{inherits}
-    inherits\endlink a specific class, for example:
+    a specific class, for example:
 
     \snippet signalsandslots/signalsandslots.cpp 5
     \snippet signalsandslots/signalsandslots.cpp 6

src/corelib/doc/src/resource-system.qdoc

@@ -69,7 +69,7 @@
 
     By default, resources are accessible in the application under the
     same file name as they have in the source tree, with a \c :/ prefix,
-    or by a \link QUrl URL\endlink with a \c qrc scheme.
+    or by a \l{QUrl}{URL} with a \c qrc scheme.
 
     For example, the file path \c :/images/cut.png or the URL
     \c qrc:///images/cut.png would give access to the

src/corelib/doc/src/threads.qdoc

@@ -659,8 +659,7 @@
 
     \section1 Threads and Rich Text Processing
 
-    The QTextDocument, QTextCursor, and \link richtext.html all
+    The QTextDocument, QTextCursor, and \l{richtext.html}{all related classes} are reentrant.
-    related classes\endlink are reentrant.
 
     Note that a QTextDocument instance created in the GUI thread may
     contain QPixmap image resources. Use QTextDocument::clone() to

src/corelib/global/qnamespace.qdoc

@@ -654,11 +654,10 @@
 
     Color/Mono preference (ignored for QBitmap):
 
-    \value AutoColor (default) - If the image has \link
+    \value AutoColor (default) - If the image has \l{QImage::depth()}{depth} 1 and contains only
-           QImage::depth() depth\endlink 1 and contains only
            black and white pixels, the pixmap becomes monochrome.
     \value ColorOnly The pixmap is dithered/converted to the
-           \link QPixmap::defaultDepth() native display depth\endlink.
+           \l{QPixmap::defaultDepth()}{native display depth}.
     \value MonoOnly The pixmap becomes monochrome. If necessary,
            it is dithered using the chosen dithering algorithm.
 

src/corelib/io/qurl.cpp

@@ -2875,7 +2875,7 @@ bool QUrl::isParentOf(const QUrl &childUrl) const
     Writes url \a url to the stream \a out and returns a reference
     to the stream.
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */
 QDataStream &operator<<(QDataStream &out, const QUrl &url)
 {
@@ -2891,7 +2891,7 @@ QDataStream &operator<<(QDataStream &out, const QUrl &url)
     Reads a url into \a url from the stream \a in and returns a
     reference to the stream.
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */
 QDataStream &operator>>(QDataStream &in, QUrl &url)
 {

src/corelib/kernel/qcoreevent.cpp

@@ -323,8 +323,7 @@ QEvent &QEvent::operator=(const QEvent &other)
 }
 
 /*!
-    Destroys the event. If it was \link
+    Destroys the event. If it was \l{QCoreApplication::postEvent()}{posted},
-    QCoreApplication::postEvent() posted \endlink,
     it will be removed from the list of events to be posted.
 */
 

src/corelib/kernel/qtimer.cpp

@@ -300,7 +300,7 @@ QT_END_INCLUDE_NAMESPACE
     This static function calls a slot after a given time interval.
 
     It is very convenient to use this function because you do not need
-    to bother with a \link QObject::timerEvent() timerEvent\endlink or
+    to bother with a \l{QObject::timerEvent()}{timerEvent} or
     create a local QTimer object.
 
     Example:
@@ -328,7 +328,7 @@ void QTimer::singleShot(int msec, QObject *receiver, const char *member)
     This static function calls a slot after a given time interval.
 
     It is very convenient to use this function because you do not need
-    to bother with a \link QObject::timerEvent() timerEvent\endlink or
+    to bother with a \l{QObject::timerEvent()}{timerEvent} or
     create a local QTimer object.
 
     The \a receiver is the receiving object and the \a member is the slot. The

src/corelib/kernel/qvariant.cpp

@@ -1769,8 +1769,7 @@ void QVariant::save(QDataStream &s) const
 
     Reads a variant \a p from the stream \a s.
 
-    \sa \link datastreamformat.html Format of the QDataStream
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
-    operators \endlink
 */
 QDataStream& operator>>(QDataStream &s, QVariant &p)
 {
@@ -1781,8 +1780,7 @@ QDataStream& operator>>(QDataStream &s, QVariant &p)
 /*!
     Writes a variant \a p to the stream \a s.
 
-    \sa \link datastreamformat.html Format of the QDataStream
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
-    operators \endlink
 */
 QDataStream& operator<<(QDataStream &s, const QVariant &p)
 {

src/corelib/tools/qbitarray.cpp

@@ -55,11 +55,10 @@ QT_BEGIN_NAMESPACE
     \reentrant
 
     A QBitArray is an array that gives access to individual bits and
-    provides operators (\link operator&() AND\endlink, \link
+    provides operators (\l{operator&()}{AND}, \l{operator|()}{OR},
-    operator|() OR\endlink, \link operator^() XOR\endlink, and \link
+    \l{operator^()}{XOR}, and \l{operator~()}{NOT}) that work on
-    operator~() NOT\endlink) that work on entire arrays of bits. It
+    entire arrays of bits. It uses \l{implicit sharing} (copy-on-write)
-    uses \l{implicit sharing} (copy-on-write) to reduce memory usage
+    to reduce memory usage and to avoid the needless copying of data.
-    and to avoid the needless copying of data.
 
     The following code constructs a QBitArray containing 200 bits
     initialized to false (0):
@@ -83,9 +82,9 @@ QT_BEGIN_NAMESPACE
 
     \snippet code/src_corelib_tools_qbitarray.cpp 2
 
-    QBitArray supports \c{&} (\link operator&() AND\endlink), \c{|}
+    QBitArray supports \c{&} (\l{operator&()}{AND}), \c{|}
-    (\link operator|() OR\endlink), \c{^} (\link operator^()
+    (\l{operator|()}{OR}), \c{^} (\l{operator^()}{XOR}),
-    XOR\endlink), \c{~} (\link operator~() NOT\endlink), as well as
+    \c{~} (\l{operator~()}{NOT}), as well as
     \c{&=}, \c{|=}, and \c{^=}. These operators work in the same way
     as the built-in C++ bitwise operators of the same name. For
     example:

src/corelib/tools/qhash.cpp

@@ -1186,8 +1186,7 @@ void QHashData::checkSanity()
     Returns the first key mapped to \a value.
 
     If the hash contains no item with the \a value, the function
-    returns a \link {default-constructed value} default-constructed
+    returns a \l{default-constructed value}{default-constructed key}.
-    key \endlink.
 
     This function can be slow (\l{linear time}), because QHash's
     internal data structure is optimized for fast lookup by key, not

src/corelib/tools/qlinkedlist.cpp

@@ -1059,7 +1059,7 @@ const QLinkedListData QLinkedListData::shared_null = {
     This function requires the value type to implement \c
     operator<<().
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */
 
 /*! \fn QDataStream &operator>>(QDataStream &in, QLinkedList<T> &list)
@@ -1069,7 +1069,7 @@ const QLinkedListData QLinkedListData::shared_null = {
 
     This function requires the value type to implement \c operator>>().
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */
 
 /*!

src/corelib/tools/qlist.cpp

@@ -1718,7 +1718,7 @@ void **QListData::erase(void **xi)
     This function requires the value type to implement \c
     operator<<().
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */
 
 /*! \fn QDataStream &operator>>(QDataStream &in, QList<T> &list)
@@ -1729,7 +1729,7 @@ void **QListData::erase(void **xi)
     This function requires the value type to implement \c
     operator>>().
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */
 
 /*! \fn QList<T> QList<T>::fromVector(const QVector<T> &vector)

src/corelib/tools/qmap.cpp

@@ -753,8 +753,8 @@ void QMapDataBase::freeData(QMapDataBase *d)
 
     Returns the first key with value \a value, or \a defaultKey if
     the map contains no item with value \a value. If no \a defaultKey
-    is provided the function returns a \link {default-constructed value}
+    is provided the function returns a
-    default-constructed key \endlink.
+    \l{default-constructed value}{default-constructed key}.
 
     This function can be slow (\l{linear time}), because QMap's
     internal data structure is optimized for fast lookup by key, not
@@ -1491,7 +1491,7 @@ void QMapDataBase::freeData(QMapDataBase *d)
     This function requires the key and value types to implement \c
     operator<<().
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */
 
 /*! \fn QDataStream &operator>>(QDataStream &in, QMap<Key, T> &map)
@@ -1502,7 +1502,7 @@ void QMapDataBase::freeData(QMapDataBase *d)
     This function requires the key and value types to implement \c
     operator>>().
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */
 
 /*! \class QMultiMap

src/corelib/tools/qregexp.cpp

@@ -236,7 +236,7 @@ int qFindString(const QChar *haystack, int haystackLen, int from,
     spellings than we want: 'Eric', 'Erik', 'Eiric' and 'Eirik'.
 
     Some of the examples discussed above are implemented in the
-    \link #code-examples code examples \endlink section.
+    \l{#code-examples}{code examples} section.
 
     \target characters-and-abbreviations-for-sets-of-characters
     \section1 Characters and Abbreviations for Sets of Characters
@@ -453,8 +453,7 @@ int qFindString(const QChar *haystack, int haystackLen, int from,
          writing \c{\\^}. For example, \b{^#include} will only
          match strings which \e begin with the characters '#include'.
          (When the caret is the first character of a character set it
-         has a special meaning, see \link #sets-of-characters Sets of
+         has a special meaning, see \l{#sets-of-characters}{Sets of Characters}.)
-         Characters \endlink.)
 
     \row \li \b{$}
          \li The dollar signifies the end of the string. For example
@@ -538,9 +537,8 @@ int qFindString(const QChar *haystack, int haystackLen, int from,
     \section1 Notes for Perl Users
 
     Most of the character class abbreviations supported by Perl are
-    supported by QRegExp, see \link
+    supported by QRegExp, see \l{#characters-and-abbreviations-for-sets-of-characters}
-    #characters-and-abbreviations-for-sets-of-characters characters
+    {characters and abbreviations for sets of characters}.
-    and abbreviations for sets of characters \endlink.
 
     In QRegExp, apart from within character classes, \c{^} always
     signifies the start of the string, so carets must always be

src/corelib/tools/qset.qdoc

@@ -939,7 +939,7 @@
 
     This function requires the value type to implement \c operator<<().
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */
 
 /*!
@@ -950,5 +950,5 @@
 
     This function requires the value type to implement \c operator>>().
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */

src/corelib/tools/qstring.cpp

@@ -7459,9 +7459,8 @@ QString &QString::setRawData(const QChar *unicode, int size)
     Many of QString's member functions are overloaded to accept
     \c{const char *} instead of QString. This includes the copy
     constructor, the assignment operator, the comparison operators,
-    and various other functions such as \link QString::insert()
+    and various other functions such as \l{QString::insert()}{insert()}, \l{QString::replace()}{replace()},
-    insert() \endlink, \link QString::replace() replace()\endlink,
+    and \l{QString::indexOf()}{indexOf()}. These functions
-    and \link QString::indexOf() indexOf()\endlink. These functions
     are usually optimized to avoid constructing a QString object for
     the \c{const char *} data. For example, assuming \c str is a
     QString,

src/corelib/tools/qvector.cpp

@@ -1011,7 +1011,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
 
     This function requires the value type to implement \c operator<<().
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */
 
 /*! \fn QDataStream &operator>>(QDataStream &in, QVector<T> &vector)
@@ -1021,7 +1021,7 @@ int QVectorData::grow(int sizeOfHeader, int size, int sizeOfT)
 
     This function requires the value type to implement \c operator>>().
 
-    \sa \link datastreamformat.html Format of the QDataStream operators \endlink
+    \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
 */
 
 QT_END_NAMESPACE