1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

QtGui: remove \link usages

Browse Source 
Change-Id: Ib8cca14a8fa35fbc631bfea9b4873225eac3677f
Reviewed-by: Casper van Donderen <casper.vandonderen@nokia.com>
This commit is contained in:
Giuseppe D'Angelo 2012-05-11 01:47:46 +01:00 committed by Qt by Nokia
parent 2c49ea852f
commit 358f78f215
13 changed files with 92 additions and 52 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
src/gui/accessible/qaccessible2.cpp
View File

@ -56,7 +56,7 @@ QT_BEGIN_NAMESPACE
\brief The QAccessible2 namespace defines constants relating to \brief The QAccessible2 namespace defines constants relating to
IAccessible2-based interfaces IAccessible2-based interfaces
\link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink \l{IAccessible2 Specification}
*/ */
/*! /*!
@ -76,7 +76,7 @@ QT_BEGIN_NAMESPACE
This interface is, for example, implemented for QLineEdit. This interface is, for example, implemented for QLineEdit.
Editable text objects should also implement \l QAccessibleEditableTextInterface. Editable text objects should also implement \l QAccessibleEditableTextInterface.
\link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink \l{IAccessible2 Specification}
*/ */
/*! /*!
@ -194,7 +194,7 @@ QT_BEGIN_NAMESPACE
\sa QAccessibleInterface \sa QAccessibleInterface
\link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink \l{IAccessible2 Specification}
*/ */
/*! /*!
@ -257,7 +257,7 @@ QT_BEGIN_NAMESPACE
\sa QAccessibleInterface, QAccessibleEditableTextInterface \sa QAccessibleInterface, QAccessibleEditableTextInterface
\link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink \l{IAccessible2 Specification}
*/ */
/*! /*!
@ -275,7 +275,7 @@ QT_BEGIN_NAMESPACE
Usually this interface is implemented by classes that also implement \l QAccessibleInterface. Usually this interface is implemented by classes that also implement \l QAccessibleInterface.
\link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink \l{IAccessible2 Specification}
*/ */
/*! /*!
@ -322,7 +322,7 @@ QT_BEGIN_NAMESPACE
\brief The QAccessibleImageInterface class implements support for \brief The QAccessibleImageInterface class implements support for
the IAccessibleImage interface. the IAccessibleImage interface.
\link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink \l{IAccessible2 Specification}
*/ */
/*! /*!
@ -333,7 +333,7 @@ QT_BEGIN_NAMESPACE
\brief The QAccessibleTableCellInterface class implements support for \brief The QAccessibleTableCellInterface class implements support for
the IAccessibleTable2 Cell interface. the IAccessibleTable2 Cell interface.
\link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink \l{IAccessible2 Specification}
*/ */
/*! /*!
@ -344,7 +344,7 @@ QT_BEGIN_NAMESPACE
\brief The QAccessibleTableInterface class implements support for \brief The QAccessibleTableInterface class implements support for
the IAccessibleTable2 interface. the IAccessibleTable2 interface.
\link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink \l{IAccessible2 Specification}
*/ */
@ -385,7 +385,7 @@ QT_BEGIN_NAMESPACE
Most widgets will simply implement \l pressAction(). This is what happens when the widget is activated by Most widgets will simply implement \l pressAction(). This is what happens when the widget is activated by
being clicked, space pressed or similar. being clicked, space pressed or similar.
\link http://www.linux-foundation.org/en/Accessibility/IAccessible2 IAccessible2 Specification \endlink \l{IAccessible2 Specification}
*/ */
/*! /*!

47
src/gui/doc/src/external-resources.qdoc Normal file
View File

@ -0,0 +1,47 @@
/****************************************************************************
**
** 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://nwalsh.com/comp.fonts/FAQ/
\title comp.fonts FAQ
*/
/*!
\externalpage http://www.linux-foundation.org/en/Accessibility/IAccessible2
\title IAccessible2 Specification
*/
/*!
\externalpage http://czyborra.com/
\title Roman Czyborra's
*/
/*!
\externalpage http://www.xfree86.org/4.3.0/Xcursor.3.html
\title Xcursor
*/

3
src/gui/doc/src/paintsystem.qdoc
View File

@ -32,8 +32,7 @@
\brief Classes that provide support for painting. \brief Classes that provide support for painting.
See also this introduction to the \link coordsys.html Qt See also this introduction to the \l{coordsys.html}{Qt coordinate system.}
coordinate system. \endlink
*/ */
/*! /*!

3
src/gui/image/qpicture.cpp
View File

@ -1833,8 +1833,7 @@ QList<QByteArray> QPictureIO::outputFormats()
Setting the picture file format string is optional. Setting the picture file format string is optional.
Note that this function does \e not set the \link format() Note that this function does \e not set the \l{format()}{format} used to read the picture. If you need that
format\endlink used to read the picture. If you need that
information, use the pictureFormat() static functions. information, use the pictureFormat() static functions.
Example: Example:

3
src/gui/kernel/qcursor.cpp
View File

@ -93,8 +93,7 @@ QT_BEGIN_NAMESPACE
\section1 A Note for X11 Users \section1 A Note for X11 Users
On X11, Qt supports the \link On X11, Qt supports the \l{Xcursor}{Xcursor}
http://www.xfree86.org/4.3.0/Xcursor.3.html Xcursor\endlink
library, which allows for full color icon themes. The table below library, which allows for full color icon themes. The table below
shows the cursor name used for each Qt::CursorShape value. If a shows the cursor name used for each Qt::CursorShape value. If a
cursor cannot be found using the name shown below, a standard X11 cursor cannot be found using the name shown below, a standard X11

7
src/gui/kernel/qkeysequence.cpp
View File

@ -933,8 +933,7 @@ QKeySequence::QKeySequence()
\a key should be in NativeText format. \a key should be in NativeText format.
This constructor is typically used with \link QObject::tr() tr This constructor is typically used with \l{QObject::tr()}{tr}(), so that shortcut keys can be replaced in
\endlink(), so that shortcut keys can be replaced in
translations: translations:
\snippet code/src_gui_kernel_qkeysequence.cpp 2 \snippet code/src_gui_kernel_qkeysequence.cpp 2
@ -1693,7 +1692,7 @@ QKeySequence QKeySequence::fromString(const QString &str, SequenceFormat format)
Writes the key \a sequence to the \a stream. Writes the key \a sequence to the \a stream.
\sa \link datastreamformat.html Format of the QDataStream operators \endlink \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
*/ */
QDataStream &operator<<(QDataStream &s, const QKeySequence &keysequence) QDataStream &operator<<(QDataStream &s, const QKeySequence &keysequence)
{ {
@ -1716,7 +1715,7 @@ QDataStream &operator<<(QDataStream &s, const QKeySequence &keysequence)
Reads a key sequence from the \a stream into the key \a sequence. Reads a key sequence from the \a stream into the key \a sequence.
\sa \link datastreamformat.html Format of the QDataStream operators \endlink \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
*/ */
QDataStream &operator>>(QDataStream &s, QKeySequence &keysequence) QDataStream &operator>>(QDataStream &s, QKeySequence &keysequence)
{ {

4
src/gui/kernel/qpalette.cpp
View File

@ -925,7 +925,7 @@ static const int oldRoles[7] = { QPalette::Foreground, QPalette::Background, QPa
Writes the palette, \a p to the stream \a s and returns a Writes the palette, \a p to the stream \a s and returns a
reference to the stream. 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 &s, const QPalette &p) QDataStream &operator<<(QDataStream &s, const QPalette &p)
@ -963,7 +963,7 @@ static void readV1ColorGroup(QDataStream &s, QPalette &pal, QPalette::ColorGroup
Reads a palette from the stream, \a s into the palette \a p, and Reads a palette from the stream, \a s into the palette \a p, and
returns a reference to the stream. 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 &s, QPalette &p) QDataStream &operator>>(QDataStream &s, QPalette &p)

4
src/gui/kernel/qwindow.cpp
View File

@ -1695,8 +1695,8 @@ void QWindowPrivate::maybeQuitOnLastWindowClosed()
\brief the cursor shape for this window \brief the cursor shape for this window
The mouse cursor will assume this shape when it is over this The mouse cursor will assume this shape when it is over this
window, unless an override cursor is set. See the \link window, unless an override cursor is set.
Qt::CursorShape list of predefined cursor objects\endlink for a See the \l{Qt::CursorShape}{list of predefined cursor objects} for a
range of useful shapes. range of useful shapes.
By default, this property contains a cursor with the Qt::ArrowCursor By default, this property contains a cursor with the Qt::ArrowCursor

8
src/gui/opengl/qopenglframebufferobject.cpp
View File

@ -83,10 +83,10 @@ QT_BEGIN_NAMESPACE
A framebuffer object has several characteristics: A framebuffer object has several characteristics:
\list \list
\li \link setSamples() Number of samples per pixels.\endlink \li \l{setSamples()}{Number of samples per pixels.}
\li \link setAttachment() Depth and/or stencil attachments.\endlink \li \l{setAttachment()}{Depth and/or stencil attachments.}
\li \link setTextureTarget() Texture target.\endlink \li \l{setTextureTarget()}{Texture target.}
\li \link setInternalTextureFormat() Internal texture format.\endlink \li \l{setInternalTextureFormat()}{Internal texture format.}
\endlist \endlist
Note that the desired attachments or number of samples per pixels might not Note that the desired attachments or number of samples per pixels might not

4
src/gui/painting/qregion.cpp
View File

@ -383,7 +383,7 @@ void QRegion::exec(const QByteArray &buffer, int ver, QDataStream::ByteOrder byt
Writes the region \a r to the stream \a s and returns a reference Writes the region \a r to the stream \a s and returns a reference
to the stream. 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 &s, const QRegion &r) QDataStream &operator<<(QDataStream &s, const QRegion &r)
@ -416,7 +416,7 @@ QDataStream &operator<<(QDataStream &s, const QRegion &r)
Reads a region from the stream \a s into \a r and returns a Reads a region from the stream \a s into \a r and returns a
reference to the stream. 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 &s, QRegion &r) QDataStream &operator>>(QDataStream &s, QRegion &r)

25
src/gui/text/qfont.cpp
View File

@ -382,7 +382,7 @@ QFontEngineData::~QFontEngineData()
QFontInfo object. QFontInfo object.
If the requested font family is unavailable you can influence the If the requested font family is unavailable you can influence the
\link #fontmatching font matching algorithm\endlink by choosing a \l{#fontmatching}{font matching algorithm} by choosing a
particular \l{QFont::StyleHint} and \l{QFont::StyleStrategy} with particular \l{QFont::StyleHint} and \l{QFont::StyleStrategy} with
setStyleHint(). The default family (corresponding to the current setStyleHint(). The default family (corresponding to the current
style hint) is returned by defaultFamily(). style hint) is returned by defaultFamily().
@ -484,9 +484,9 @@ QFontEngineData::~QFontEngineData()
\snippet code/src_gui_text_qfont.cpp 4 \snippet code/src_gui_text_qfont.cpp 4
For more general information on fonts, see the For more general information on fonts, see the
\link http://nwalsh.com/comp.fonts/FAQ/ comp.fonts FAQ.\endlink \l{comp.fonts FAQ}{comp.fonts FAQ}.
Information on encodings can be found from Information on encodings can be found from
\link http://czyborra.com/ Roman Czyborra's\endlink page. \l{Roman Czyborra's} page.
\sa QFontComboBox, QFontMetrics, QFontInfo, QFontDatabase, {Character Map Example} \sa QFontComboBox, QFontMetrics, QFontInfo, QFontDatabase, {Character Map Example}
*/ */
@ -626,7 +626,7 @@ QFontEngineData::~QFontEngineData()
It is theoretically possible that there really isn't a It is theoretically possible that there really isn't a
lastResortFont() in which case Qt will abort with an error lastResortFont() in which case Qt will abort with an error
message. We have not been able to identify a case where this message. We have not been able to identify a case where this
happens. Please \link bughowto.html report it as a bug\endlink if happens. Please \l{bughowto.html}{report it as a bug} if
it does, preferably with a list of the fonts you have installed. it does, preferably with a list of the fonts you have installed.
\sa lastResortFamily(), rawName() \sa lastResortFamily(), rawName()
@ -1106,8 +1106,8 @@ void QFont::setWeight(int weight)
/*! /*!
\fn bool QFont::bold() const \fn bool QFont::bold() const
Returns true if weight() is a value greater than \link Weight Returns true if weight() is a value greater than
QFont::Normal \endlink; otherwise returns false. \l{Weight}{QFont::Normal}; otherwise returns false.
\sa weight(), setBold(), QFontInfo::bold() \sa weight(), setBold(), QFontInfo::bold()
*/ */
@ -1115,9 +1115,9 @@ void QFont::setWeight(int weight)
/*! /*!
\fn void QFont::setBold(bool enable) \fn void QFont::setBold(bool enable)
If \a enable is true sets the font's weight to \link Weight If \a enable is true sets the font's weight to
QFont::Bold \endlink; otherwise sets the weight to \link Weight \l{Weight}{QFont::Bold};
QFont::Normal\endlink. otherwise sets the weight to \l{Weight}{QFont::Normal}.
For finer boldness control use setWeight(). For finer boldness control use setWeight().
@ -2097,7 +2097,7 @@ void QFont::cacheStatistics()
Writes the font \a font to the data stream \a s. (toString() Writes the font \a font to the data stream \a s. (toString()
writes to a text stream.) writes to a text stream.)
\sa \link datastreamformat.html Format of the QDataStream operators \endlink \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
*/ */
QDataStream &operator<<(QDataStream &s, const QFont &font) QDataStream &operator<<(QDataStream &s, const QFont &font)
{ {
@ -2148,7 +2148,7 @@ QDataStream &operator<<(QDataStream &s, const QFont &font)
Reads the font \a font from the data stream \a s. (fromString() Reads the font \a font from the data stream \a s. (fromString()
reads from a text stream.) reads from a text stream.)
\sa \link datastreamformat.html Format of the QDataStream operators \endlink \sa{Serializing Qt Data Types}{Format of the QDataStream operators}
*/ */
QDataStream &operator>>(QDataStream &s, QFont &font) QDataStream &operator>>(QDataStream &s, QFont &font)
{ {
@ -2273,8 +2273,7 @@ QDataStream &operator>>(QDataStream &s, QFont &font)
Constructs a font info object for \a font. Constructs a font info object for \a font.
The font must be screen-compatible, i.e. a font you use when The font must be screen-compatible, i.e. a font you use when
drawing text in \link QWidget widgets\endlink or \link QPixmap drawing text in \l{QWidget}{widgets} or \l{QPixmap}{pixmaps}, not QPicture or QPrinter.
pixmaps\endlink, not QPicture or QPrinter.
The font info object holds the information for the font that is The font info object holds the information for the font that is
passed in the constructor at the time it is created, and is not passed in the constructor at the time it is created, and is not

12
src/gui/text/qfontmetrics.cpp
View File

@ -166,7 +166,7 @@ QFontMetrics::QFontMetrics(const QFont &font)
The font metrics will be compatible with the paintdevice passed. The font metrics will be compatible with the paintdevice passed.
If the \a paintdevice is 0, the metrics will be screen-compatible, If the \a paintdevice is 0, the metrics will be screen-compatible,
ie. the metrics you get if you use the font for drawing text on a ie. the metrics you get if you use the font for drawing text on a
\link QWidget widgets\endlink or \link QPixmap pixmaps\endlink, \l{QWidget}{widgets} or \l{QPixmap}{pixmaps},
not on a QPicture or QPrinter. not on a QPicture or QPrinter.
The font metrics object holds the information for the font that is The font metrics object holds the information for the font that is
@ -751,8 +751,8 @@ QRect QFontMetrics::boundingRect(QChar ch) const
The bounding rectangle returned by this function is somewhat larger The bounding rectangle returned by this function is somewhat larger
than that calculated by the simpler boundingRect() function. This than that calculated by the simpler boundingRect() function. This
function uses the \link minLeftBearing() maximum left \endlink and function uses the \l{minLeftBearing()}{maximum left} and
\link minRightBearing() right \endlink font bearings as is \l{minRightBearing()}{right} font bearings as is
necessary for multi-line text to align correctly. Also, necessary for multi-line text to align correctly. Also,
fontHeight() and lineSpacing() are used to calculate the height, fontHeight() and lineSpacing() are used to calculate the height,
rather than individual character heights. rather than individual character heights.
@ -1027,7 +1027,7 @@ QFontMetricsF::QFontMetricsF(const QFont &font)
The font metrics will be compatible with the paintdevice passed. The font metrics will be compatible with the paintdevice passed.
If the \a paintdevice is 0, the metrics will be screen-compatible, If the \a paintdevice is 0, the metrics will be screen-compatible,
ie. the metrics you get if you use the font for drawing text on a ie. the metrics you get if you use the font for drawing text on a
\link QWidget widgets\endlink or \link QPixmap pixmaps\endlink, \l{QWidget}{widgets} or \l{QPixmap}{pixmaps},
not on a QPicture or QPrinter. not on a QPicture or QPrinter.
The font metrics object holds the information for the font that is The font metrics object holds the information for the font that is
@ -1532,8 +1532,8 @@ QRectF QFontMetricsF::boundingRect(QChar ch) const
The bounding rectangle returned by this function is somewhat larger The bounding rectangle returned by this function is somewhat larger
than that calculated by the simpler boundingRect() function. This than that calculated by the simpler boundingRect() function. This
function uses the \link minLeftBearing() maximum left \endlink and function uses the \l{minLeftBearing()}{maximum left} and
\link minRightBearing() right \endlink font bearings as is \l{minRightBearing()}{right} font bearings as is
necessary for multi-line text to align correctly. Also, necessary for multi-line text to align correctly. Also,
fontHeight() and lineSpacing() are used to calculate the height, fontHeight() and lineSpacing() are used to calculate the height,
rather than individual character heights. rather than individual character heights.

6
src/gui/text/qtextdocument.cpp
View File

@ -400,8 +400,7 @@ void QTextDocument::undo(QTextCursor *cursor)
/*! /*!
\since 4.2 \since 4.2
Redoes the last editing operation on the document if \link Redoes the last editing operation on the document if \l{QTextDocument::isRedoAvailable()}{redo is available}.
QTextDocument::isRedoAvailable() redo is available\endlink.
The provided \a cursor is positioned at the end of the location where The provided \a cursor is positioned at the end of the location where
the edition operation was redone. the edition operation was redone.
@ -452,8 +451,7 @@ void QTextDocument::undo()
/*! /*!
\overload \overload
Redoes the last editing operation on the document if \link Redoes the last editing operation on the document if \l{QTextDocument::isRedoAvailable()}{redo is available}.
QTextDocument::isRedoAvailable() redo is available\endlink.
*/ */
void QTextDocument::redo() void QTextDocument::redo()
{ {