From ad97aba452ed7d3dbd3c9d437c59c14b2ae0661b Mon Sep 17 00:00:00 2001 From: Marius Storm-Olsen Date: Thu, 10 May 2012 13:10:23 +0200 Subject: Doc: Fix \sa usage Ensure comma between elements (757 missing), single space and curly- braces around title elements, etc. Change-Id: Id16c3fda7fc47a12a0682f8720214f4990609a97 Reviewed-by: Giuseppe D'Angelo Reviewed-by: Casper van Donderen --- src/widgets/dialogs/qdialog.cpp | 4 +- src/widgets/dialogs/qsidebar.cpp | 2 +- src/widgets/graphicsview/qgraphicsitem.cpp | 2 +- src/widgets/graphicsview/qgraphicswidget.cpp | 8 ++-- src/widgets/itemviews/qabstractitemdelegate.cpp | 2 +- src/widgets/itemviews/qabstractitemview.cpp | 26 +++++------ src/widgets/itemviews/qcolumnview.cpp | 2 +- src/widgets/itemviews/qdirmodel.cpp | 3 +- src/widgets/itemviews/qheaderview.cpp | 14 +++--- src/widgets/itemviews/qlistwidget.cpp | 12 ++--- src/widgets/itemviews/qproxymodel.cpp | 7 +-- src/widgets/itemviews/qstandarditemmodel.cpp | 10 ++-- src/widgets/itemviews/qtableview.cpp | 12 ++--- src/widgets/itemviews/qtablewidget.cpp | 14 +++--- src/widgets/itemviews/qtreeview.cpp | 6 +-- src/widgets/itemviews/qtreewidget.cpp | 14 +++--- src/widgets/kernel/qaction.cpp | 8 ++-- src/widgets/kernel/qapplication.cpp | 2 +- src/widgets/kernel/qboxlayout.cpp | 2 +- src/widgets/kernel/qwhatsthis.cpp | 4 +- src/widgets/kernel/qwidget.cpp | 62 ++++++++++++------------- src/widgets/styles/qmacstyle.qdoc | 2 +- src/widgets/styles/qstyle.cpp | 4 +- src/widgets/styles/qstyleoption.cpp | 2 +- src/widgets/util/qsystemtrayicon.cpp | 2 +- src/widgets/util/qundogroup.cpp | 40 ++++++++-------- src/widgets/util/qundostack.cpp | 32 ++++++------- src/widgets/util/qundoview.cpp | 8 ++-- src/widgets/widgets/qabstractslider.cpp | 4 +- src/widgets/widgets/qbuttongroup.cpp | 8 ++-- src/widgets/widgets/qcheckbox.cpp | 4 +- src/widgets/widgets/qcommandlinkbutton.cpp | 2 +- src/widgets/widgets/qdialogbuttonbox.cpp | 6 +-- src/widgets/widgets/qdockwidget.cpp | 4 +- src/widgets/widgets/qframe.cpp | 4 +- src/widgets/widgets/qlineedit.cpp | 20 ++++---- src/widgets/widgets/qmainwindow.cpp | 10 ++-- src/widgets/widgets/qmenu.cpp | 12 ++--- src/widgets/widgets/qmenubar.cpp | 10 ++-- src/widgets/widgets/qplaintextedit.cpp | 8 ++-- src/widgets/widgets/qprogressbar.cpp | 2 +- src/widgets/widgets/qsizegrip.cpp | 2 +- src/widgets/widgets/qspinbox.cpp | 10 ++-- src/widgets/widgets/qsplitter.cpp | 8 ++-- src/widgets/widgets/qtabbar.cpp | 8 ++-- src/widgets/widgets/qtabwidget.cpp | 10 ++-- src/widgets/widgets/qtextedit.cpp | 22 ++++----- src/widgets/widgets/qtoolbar.cpp | 6 +-- 48 files changed, 234 insertions(+), 232 deletions(-) (limited to 'src/widgets') diff --git a/src/widgets/dialogs/qdialog.cpp b/src/widgets/dialogs/qdialog.cpp index fb03d3b579..2e60be70f7 100644 --- a/src/widgets/dialogs/qdialog.cpp +++ b/src/widgets/dialogs/qdialog.cpp @@ -579,7 +579,7 @@ void QDialog::done(int r) /*! Hides the modal dialog and sets the result code to \c Accepted. - \sa reject() done() + \sa reject(), done() */ void QDialog::accept() @@ -590,7 +590,7 @@ void QDialog::accept() /*! Hides the modal dialog and sets the result code to \c Rejected. - \sa accept() done() + \sa accept(), done() */ void QDialog::reject() diff --git a/src/widgets/dialogs/qsidebar.cpp b/src/widgets/dialogs/qsidebar.cpp index 00f60f7e77..84a62a8398 100644 --- a/src/widgets/dialogs/qsidebar.cpp +++ b/src/widgets/dialogs/qsidebar.cpp @@ -355,7 +355,7 @@ void QUrlModel::layoutChanged() /*! The following path changed data update our copy of that data - \sa layoutChanged() dataChanged() + \sa layoutChanged(), dataChanged() */ void QUrlModel::changed(const QString &path) { diff --git a/src/widgets/graphicsview/qgraphicsitem.cpp b/src/widgets/graphicsview/qgraphicsitem.cpp index 1ce914b219..56ea4f986c 100644 --- a/src/widgets/graphicsview/qgraphicsitem.cpp +++ b/src/widgets/graphicsview/qgraphicsitem.cpp @@ -2057,7 +2057,7 @@ void QGraphicsItem::setPanelModality(PanelModality panelModality) This function always returns false for items not in a scene. - \sa panelModality() setPanelModality() PanelModality + \sa panelModality(), setPanelModality(), PanelModality */ bool QGraphicsItem::isBlockedByModalPanel(QGraphicsItem **blockingPanel) const { diff --git a/src/widgets/graphicsview/qgraphicswidget.cpp b/src/widgets/graphicsview/qgraphicswidget.cpp index 267d70104d..cf55827854 100644 --- a/src/widgets/graphicsview/qgraphicswidget.cpp +++ b/src/widgets/graphicsview/qgraphicswidget.cpp @@ -1890,7 +1890,7 @@ QGraphicsWidget *QGraphicsWidget::focusWidget() const key sequence, so are much easier to use than this low-level function. - \sa releaseShortcut() setShortcutEnabled() QWidget::grabShortcut() + \sa releaseShortcut(), setShortcutEnabled(), QWidget::grabShortcut() */ int QGraphicsWidget::grabShortcut(const QKeySequence &sequence, Qt::ShortcutContext context) { @@ -1916,7 +1916,7 @@ int QGraphicsWidget::grabShortcut(const QKeySequence &sequence, Qt::ShortcutCont this low-level function. Note also that this is an expensive operation. - \sa grabShortcut() setShortcutEnabled() , QWidget::releaseShortcut() + \sa grabShortcut(), setShortcutEnabled(), QWidget::releaseShortcut() */ void QGraphicsWidget::releaseShortcut(int id) { @@ -1937,7 +1937,7 @@ void QGraphicsWidget::releaseShortcut(int id) to use QAction or QShortcut to handle shortcuts, since they are easier to use than this low-level function. - \sa grabShortcut() releaseShortcut(), QWidget::setShortcutEnabled() + \sa grabShortcut(), releaseShortcut(), QWidget::setShortcutEnabled() */ void QGraphicsWidget::setShortcutEnabled(int id, bool enabled) { @@ -1952,7 +1952,7 @@ void QGraphicsWidget::setShortcutEnabled(int id, bool enabled) If \a enabled is true, auto repeat of the shortcut with the given \a id is enabled; otherwise it is disabled. - \sa grabShortcut() releaseShortcut() QWidget::setShortcutAutoRepeat() + \sa grabShortcut(), releaseShortcut(), QWidget::setShortcutAutoRepeat() */ void QGraphicsWidget::setShortcutAutoRepeat(int id, bool enabled) { diff --git a/src/widgets/itemviews/qabstractitemdelegate.cpp b/src/widgets/itemviews/qabstractitemdelegate.cpp index 890eba3407..21c67cb297 100644 --- a/src/widgets/itemviews/qabstractitemdelegate.cpp +++ b/src/widgets/itemviews/qabstractitemdelegate.cpp @@ -232,7 +232,7 @@ QAbstractItemDelegate::~QAbstractItemDelegate() editor paints its own background (e.g., with \l{QWidget::}{setAutoFillBackground()}). - \sa destroyEditor() setModelData() setEditorData() + \sa destroyEditor(), setModelData(), setEditorData() */ QWidget *QAbstractItemDelegate::createEditor(QWidget *, const QStyleOptionViewItem &, diff --git a/src/widgets/itemviews/qabstractitemview.cpp b/src/widgets/itemviews/qabstractitemview.cpp index 777767ee70..a53f3f1465 100644 --- a/src/widgets/itemviews/qabstractitemview.cpp +++ b/src/widgets/itemviews/qabstractitemview.cpp @@ -1009,7 +1009,7 @@ QAbstractItemDelegate *QAbstractItemView::itemDelegate(const QModelIndex &index) and, in many-item selections, whether the selection must be a continuous range of items. - \sa SelectionMode SelectionBehavior + \sa SelectionMode, SelectionBehavior */ void QAbstractItemView::setSelectionMode(SelectionMode mode) { @@ -1030,7 +1030,7 @@ QAbstractItemView::SelectionMode QAbstractItemView::selectionMode() const This property holds whether selections are done in terms of single items, rows or columns. - \sa SelectionMode SelectionBehavior + \sa SelectionMode, SelectionBehavior */ void QAbstractItemView::setSelectionBehavior(QAbstractItemView::SelectionBehavior behavior) @@ -1383,7 +1383,7 @@ bool QAbstractItemView::tabKeyNavigation() const \property QAbstractItemView::showDropIndicator \brief whether the drop indicator is shown when dragging items and dropping. - \sa dragEnabled DragDropMode dragDropOverwriteMode acceptDrops + \sa dragEnabled, DragDropMode, dragDropOverwriteMode, acceptDrops */ void QAbstractItemView::setDropIndicatorShown(bool enable) @@ -1402,7 +1402,7 @@ bool QAbstractItemView::showDropIndicator() const \property QAbstractItemView::dragEnabled \brief whether the view supports dragging of its own items - \sa showDropIndicator DragDropMode dragDropOverwriteMode acceptDrops + \sa showDropIndicator, DragDropMode, dragDropOverwriteMode, acceptDrops */ void QAbstractItemView::setDragEnabled(bool enable) @@ -1434,7 +1434,7 @@ bool QAbstractItemView::dragEnabled() const Note that the model used needs to provide support for drag and drop operations. - \sa setDragDropMode() {Using drag and drop with item views} + \sa setDragDropMode(), {Using drag and drop with item views} */ /*! @@ -1442,7 +1442,7 @@ bool QAbstractItemView::dragEnabled() const \brief the drag and drop event the view will act upon \since 4.2 - \sa showDropIndicator dragDropOverwriteMode + \sa showDropIndicator, dragDropOverwriteMode */ void QAbstractItemView::setDragDropMode(DragDropMode behavior) { @@ -1483,7 +1483,7 @@ QAbstractItemView::DragDropMode QAbstractItemView::dragDropMode() const actions support CopyAction. \since 4.6 - \sa showDropIndicator dragDropOverwriteMode + \sa showDropIndicator, dragDropOverwriteMode */ void QAbstractItemView::setDefaultDropAction(Qt::DropAction dropAction) { @@ -1905,7 +1905,7 @@ void QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event) the widget. If the drag is over a valid dropping place (e.g. over an item that accepts drops), the event is accepted; otherwise it is ignored. - \sa dropEvent() startDrag() + \sa dropEvent(), startDrag() */ void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event) { @@ -1927,7 +1927,7 @@ void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event) the user drags a selection to view's right or bottom edge. In this case, the event will be accepted; otherwise it will be ignored. - \sa dropEvent() startDrag() + \sa dropEvent(), startDrag() */ void QAbstractItemView::dragMoveEvent(QDragMoveEvent *event) { @@ -2863,7 +2863,7 @@ void QAbstractItemView::editorDestroyed(QObject *editor) Note that if the view has a horizontal header, the item steps will be ignored and the header section size will be used instead. - \sa horizontalStepsPerItem() setVerticalStepsPerItem() + \sa horizontalStepsPerItem(), setVerticalStepsPerItem() */ void QAbstractItemView::setHorizontalStepsPerItem(int steps) { @@ -2875,7 +2875,7 @@ void QAbstractItemView::setHorizontalStepsPerItem(int steps) \obsolete Returns the horizontal scroll bar's steps per item. - \sa setHorizontalStepsPerItem() verticalStepsPerItem() + \sa setHorizontalStepsPerItem(), verticalStepsPerItem() */ int QAbstractItemView::horizontalStepsPerItem() const { @@ -2892,7 +2892,7 @@ int QAbstractItemView::horizontalStepsPerItem() const Note that if the view has a vertical header, the item steps will be ignored and the header section size will be used instead. - \sa verticalStepsPerItem() setHorizontalStepsPerItem() + \sa verticalStepsPerItem(), setHorizontalStepsPerItem() */ void QAbstractItemView::setVerticalStepsPerItem(int steps) { @@ -2904,7 +2904,7 @@ void QAbstractItemView::setVerticalStepsPerItem(int steps) \obsolete Returns the vertical scroll bar's steps per item. - \sa setVerticalStepsPerItem() horizontalStepsPerItem() + \sa setVerticalStepsPerItem(), horizontalStepsPerItem() */ int QAbstractItemView::verticalStepsPerItem() const { diff --git a/src/widgets/itemviews/qcolumnview.cpp b/src/widgets/itemviews/qcolumnview.cpp index 6758aeb337..83cea4fd15 100644 --- a/src/widgets/itemviews/qcolumnview.cpp +++ b/src/widgets/itemviews/qcolumnview.cpp @@ -663,7 +663,7 @@ void QColumnViewPrivate::_q_clicked(const QModelIndex &index) Return the new view - \sa createColumn() setPreviewWidget() + \sa createColumn(), setPreviewWidget() \sa doLayout() */ QAbstractItemView *QColumnViewPrivate::createColumn(const QModelIndex &index, bool show) diff --git a/src/widgets/itemviews/qdirmodel.cpp b/src/widgets/itemviews/qdirmodel.cpp index 6ecf3c75aa..db2f437890 100644 --- a/src/widgets/itemviews/qdirmodel.cpp +++ b/src/widgets/itemviews/qdirmodel.cpp @@ -734,7 +734,8 @@ void QDirModel::setSorting(QDir::SortFlags sort) /*! Returns the sorting method used for the directory model. - \sa QDir::SortFlags */ + \sa QDir::SortFlags +*/ QDir::SortFlags QDirModel::sorting() const { diff --git a/src/widgets/itemviews/qheaderview.cpp b/src/widgets/itemviews/qheaderview.cpp index 4ab984b53c..0a7f9de0b3 100644 --- a/src/widgets/itemviews/qheaderview.cpp +++ b/src/widgets/itemviews/qheaderview.cpp @@ -185,7 +185,7 @@ QDataStream &operator>>(QDataStream &in, QHeaderViewPrivate::SectionItem §io The following values are obsolete: \value Custom Use Fixed instead. - \sa setResizeMode() setSectionResizeMode() stretchLastSection minimumSectionSize + \sa setResizeMode(), setSectionResizeMode(), stretchLastSection, minimumSectionSize */ /*! @@ -1019,7 +1019,7 @@ void QHeaderView::setSectionHidden(int logicalIndex, bool hide) /*! Returns the number of sections in the header. - \sa sectionCountChanged(), length() + \sa sectionCountChanged(), length() */ int QHeaderView::count() const @@ -1334,7 +1334,7 @@ bool QHeaderView::isSortIndicatorShown() const and the model will return to its natural, unsorted order. Note that not all models support this and may even crash in this case. - \sa sortIndicatorSection() sortIndicatorOrder() + \sa sortIndicatorSection(), sortIndicatorOrder() */ void QHeaderView::setSortIndicator(int logicalIndex, Qt::SortOrder order) @@ -1370,7 +1370,7 @@ void QHeaderView::setSortIndicator(int logicalIndex, Qt::SortOrder order) Returns the logical index of the section that has a sort indicator. By default this is section 0. - \sa setSortIndicator() sortIndicatorOrder() setSortIndicatorShown() + \sa setSortIndicator(), sortIndicatorOrder(), setSortIndicatorShown() */ int QHeaderView::sortIndicatorSection() const @@ -1383,7 +1383,7 @@ int QHeaderView::sortIndicatorSection() const Returns the order for the sort indicator. If no section has a sort indicator the return value of this function is undefined. - \sa setSortIndicator() sortIndicatorSection() + \sa setSortIndicator(), sortIndicatorSection() */ Qt::SortOrder QHeaderView::sortIndicatorOrder() const @@ -1458,7 +1458,7 @@ void QHeaderView::setCascadingSectionResizes(bool enable) This property only affects sections that have \l Interactive or \l Fixed as their resize mode. - \sa setSectionResizeMode() minimumSectionSize + \sa setSectionResizeMode(), minimumSectionSize */ int QHeaderView::defaultSectionSize() const { @@ -1484,7 +1484,7 @@ void QHeaderView::setDefaultSectionSize(int size) This property is honored by all \l{ResizeMode}{resize modes}. - \sa setSectionResizeMode() defaultSectionSize + \sa setSectionResizeMode(), defaultSectionSize */ int QHeaderView::minimumSectionSize() const { diff --git a/src/widgets/itemviews/qlistwidget.cpp b/src/widgets/itemviews/qlistwidget.cpp index 4a17b65328..23b7989634 100644 --- a/src/widgets/itemviews/qlistwidget.cpp +++ b/src/widgets/itemviews/qlistwidget.cpp @@ -853,7 +853,7 @@ QDataStream &operator>>(QDataStream &in, QListWidgetItem &item) Returns the list item's tooltip. - \sa setToolTip() statusTip() whatsThis() + \sa setToolTip(), statusTip(), whatsThis() */ /*! @@ -861,7 +861,7 @@ QDataStream &operator>>(QDataStream &in, QListWidgetItem &item) Returns the list item's "What's This?" help text. - \sa setWhatsThis() statusTip() toolTip() + \sa setWhatsThis(), statusTip(), toolTip() */ /*! @@ -891,7 +891,7 @@ QDataStream &operator>>(QDataStream &in, QListWidgetItem &item) Returns the brush used to display the list item's background. - \sa setBackground() foreground() + \sa setBackground(), foreground() */ /*! @@ -909,7 +909,7 @@ QDataStream &operator>>(QDataStream &in, QListWidgetItem &item) Returns the brush used to display the list item's foreground (e.g. text). - \sa setForeground() background() + \sa setForeground(), background() */ /*! @@ -1019,7 +1019,7 @@ void QListWidgetItem::setFlags(Qt::ItemFlags aflags) { Sets the background brush of the list item to the given \a brush. - \sa background() setForeground() + \sa background(), setForeground() */ /*! @@ -1035,7 +1035,7 @@ void QListWidgetItem::setFlags(Qt::ItemFlags aflags) { Sets the foreground brush of the list item to the given \a brush. - \sa foreground() setBackground() + \sa foreground(), setBackground() */ /*! diff --git a/src/widgets/itemviews/qproxymodel.cpp b/src/widgets/itemviews/qproxymodel.cpp index c004ccb19a..479212422b 100644 --- a/src/widgets/itemviews/qproxymodel.cpp +++ b/src/widgets/itemviews/qproxymodel.cpp @@ -74,7 +74,7 @@ QT_BEGIN_NAMESPACE representation, proxy models must create their own model indexes instead of supplying model indexes from their underlying models. - \sa \link model-view-programming.html Model/View Programming\endlink QAbstractItemModel + \sa {Model/View Programming}, QAbstractItemModel */ @@ -204,7 +204,7 @@ QVariant QProxyModel::data(const QModelIndex &index, int role) const The base class implementation returns false. This function and data() must be reimplemented for editable models. - \sa data() itemData() QAbstractItemModel::setData() + \sa data(), itemData(), QAbstractItemModel::setData() */ bool QProxyModel::setData(const QModelIndex &index, const QVariant &value, int role) { @@ -295,7 +295,8 @@ Qt::DropActions QProxyModel::supportedDropActions() const Returns true if the rows were successfully inserted; otherwise returns false. - \sa QAbstractItemModel::insertRows()*/ + \sa QAbstractItemModel::insertRows() +*/ bool QProxyModel::insertRows(int row, int count, const QModelIndex &parent) { Q_D(const QProxyModel); diff --git a/src/widgets/itemviews/qstandarditemmodel.cpp b/src/widgets/itemviews/qstandarditemmodel.cpp index 4f488993f8..17a7341b7c 100644 --- a/src/widgets/itemviews/qstandarditemmodel.cpp +++ b/src/widgets/itemviews/qstandarditemmodel.cpp @@ -992,7 +992,7 @@ Qt::ItemFlags QStandardItem::flags() const Sets the font used to display the item's text to the given \a font. - \sa font() setText() setForeground() + \sa font(), setText(), setForeground() */ /*! @@ -1000,7 +1000,7 @@ Qt::ItemFlags QStandardItem::flags() const Returns the brush used to render the item's background. - \sa foreground() setBackground() + \sa foreground(), setBackground() */ /*! @@ -1008,7 +1008,7 @@ Qt::ItemFlags QStandardItem::flags() const Sets the item's background brush to the specified \a brush. - \sa background() setForeground() + \sa background(), setForeground() */ /*! @@ -1016,7 +1016,7 @@ Qt::ItemFlags QStandardItem::flags() const Returns the brush used to render the item's foreground (e.g. text). - \sa setForeground() background() + \sa setForeground(), background() */ /*! @@ -1025,7 +1025,7 @@ Qt::ItemFlags QStandardItem::flags() const Sets the brush used to display the item's foreground (e.g. text) to the given \a brush. - \sa foreground() setBackground() setFont() + \sa foreground(), setBackground(), setFont() */ /*! diff --git a/src/widgets/itemviews/qtableview.cpp b/src/widgets/itemviews/qtableview.cpp index e997f7e9d6..b851907b08 100644 --- a/src/widgets/itemviews/qtableview.cpp +++ b/src/widgets/itemviews/qtableview.cpp @@ -1169,7 +1169,7 @@ QHeaderView *QTableView::verticalHeader() const /*! Sets the widget to use for the horizontal header to \a header. - \sa horizontalHeader() setVerticalHeader() + \sa horizontalHeader(), setVerticalHeader() */ void QTableView::setHorizontalHeader(QHeaderView *header) { @@ -1206,7 +1206,7 @@ void QTableView::setHorizontalHeader(QHeaderView *header) /*! Sets the widget to use for the vertical header to \a header. - \sa verticalHeader() setHorizontalHeader() + \sa verticalHeader(), setHorizontalHeader() */ void QTableView::setVerticalHeader(QHeaderView *header) { @@ -2876,7 +2876,7 @@ void QTableView::selectColumn(int column) /*! Hide the given \a row. - \sa showRow() hideColumn() + \sa showRow(), hideColumn() */ void QTableView::hideRow(int row) { @@ -2887,7 +2887,7 @@ void QTableView::hideRow(int row) /*! Hide the given \a column. - \sa showColumn() hideRow() + \sa showColumn(), hideRow() */ void QTableView::hideColumn(int column) { @@ -2898,7 +2898,7 @@ void QTableView::hideColumn(int column) /*! Show the given \a row. - \sa hideRow() showColumn() + \sa hideRow(), showColumn() */ void QTableView::showRow(int row) { @@ -2909,7 +2909,7 @@ void QTableView::showRow(int row) /*! Show the given \a column. - \sa hideColumn() showRow() + \sa hideColumn(), showRow() */ void QTableView::showColumn(int column) { diff --git a/src/widgets/itemviews/qtablewidget.cpp b/src/widgets/itemviews/qtablewidget.cpp index a50b6f3111..d9d377a548 100644 --- a/src/widgets/itemviews/qtablewidget.cpp +++ b/src/widgets/itemviews/qtablewidget.cpp @@ -1118,7 +1118,7 @@ void QTableWidgetItem::setFlags(Qt::ItemFlags aflags) Sets the item's text to the \a text specified. - \sa text() setFont() setForeground() + \sa text(), setFont(), setForeground() */ /*! @@ -1152,7 +1152,7 @@ void QTableWidgetItem::setFlags(Qt::ItemFlags aflags) \a statusTip. QTableWidget mouse tracking needs to be enabled for this feature to work. - \sa statusTip() setToolTip() setWhatsThis() + \sa statusTip(), setToolTip(), setWhatsThis() */ /*! @@ -1168,7 +1168,7 @@ void QTableWidgetItem::setFlags(Qt::ItemFlags aflags) Sets the item's tooltip to the string specified by \a toolTip. - \sa toolTip() setStatusTip() setWhatsThis() + \sa toolTip(), setStatusTip(), setWhatsThis() */ /*! @@ -1184,7 +1184,7 @@ void QTableWidgetItem::setFlags(Qt::ItemFlags aflags) Sets the item's "What's This?" help to the string specified by \a whatsThis. - \sa whatsThis() setStatusTip() setToolTip() + \sa whatsThis(), setStatusTip(), setToolTip() */ /*! @@ -1200,7 +1200,7 @@ void QTableWidgetItem::setFlags(Qt::ItemFlags aflags) Sets the font used to display the item's text to the given \a font. - \sa font() setText() setForeground() + \sa font(), setText(), setForeground() */ /*! @@ -1724,7 +1724,7 @@ void QTableWidgetPrivate::_q_dataChanged(const QModelIndex &topLeft, This signal is emitted whenever the selection changes. - \sa selectedItems() QTableWidgetItem::isSelected() + \sa selectedItems(), QTableWidgetItem::isSelected() */ @@ -1950,7 +1950,7 @@ QTableWidgetItem *QTableWidget::item(int row, int column) const you to use the same \a row argument for all items in the same row (i.e. setItem() will not move the row). - \sa item() takeItem() + \sa item(), takeItem() */ void QTableWidget::setItem(int row, int column, QTableWidgetItem *item) { diff --git a/src/widgets/itemviews/qtreeview.cpp b/src/widgets/itemviews/qtreeview.cpp index 44dd4b0761..510ae41d2d 100644 --- a/src/widgets/itemviews/qtreeview.cpp +++ b/src/widgets/itemviews/qtreeview.cpp @@ -2614,7 +2614,7 @@ void QTreeView::selectAll() Warning: if the model contains a large number of items, this function will take some time to execute. - \sa collapseAll() expand() collapse() setExpanded() + \sa collapseAll(), expand(), collapse(), setExpanded() */ void QTreeView::expandAll() { @@ -2631,7 +2631,7 @@ void QTreeView::expandAll() Collapses all expanded items. - \sa expandAll() expand() collapse() setExpanded() + \sa expandAll(), expand(), collapse(), setExpanded() */ void QTreeView::collapseAll() { @@ -2644,7 +2644,7 @@ void QTreeView::collapseAll() \since 4.3 Expands all expandable items to the given \a depth. - \sa expandAll() collapseAll() expand() collapse() setExpanded() + \sa expandAll(), collapseAll(), expand(), collapse(), setExpanded() */ void QTreeView::expandToDepth(int depth) { diff --git a/src/widgets/itemviews/qtreewidget.cpp b/src/widgets/itemviews/qtreewidget.cpp index d9d6c1434c..d27eaf6805 100644 --- a/src/widgets/itemviews/qtreewidget.cpp +++ b/src/widgets/itemviews/qtreewidget.cpp @@ -1067,7 +1067,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev) Sets the text to be displayed in the given \a column to the given \a text. - \sa text() setFont() setForeground() + \sa text(), setFont(), setForeground() */ /*! @@ -1100,7 +1100,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev) Sets the status tip for the given \a column to the given \a statusTip. QTreeWidget mouse tracking needs to be enabled for this feature to work. - \sa statusTip() setToolTip() setWhatsThis() + \sa statusTip(), setToolTip(), setWhatsThis() */ /*! @@ -1116,7 +1116,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev) Sets the tooltip for the given \a column to \a toolTip. - \sa toolTip() setStatusTip() setWhatsThis() + \sa toolTip(), setStatusTip(), setWhatsThis() */ /*! @@ -1132,7 +1132,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev) Sets the "What's This?" help for the given \a column to \a whatsThis. - \sa whatsThis() setStatusTip() setToolTip() + \sa whatsThis(), setStatusTip(), setToolTip() */ /*! @@ -1149,7 +1149,7 @@ void QTreeModel::timerEvent(QTimerEvent *ev) Sets the font used to display the text in the given \a column to the given \a font. - \sa font() setText() setForeground() + \sa font(), setText(), setForeground() */ /*! @@ -1881,7 +1881,7 @@ QTreeWidgetItem &QTreeWidgetItem::operator=(const QTreeWidgetItem &other) /*! Appends the \a child item to the list of children. - \sa insertChild() takeChild() + \sa insertChild(), takeChild() */ void QTreeWidgetItem::addChild(QTreeWidgetItem *child) { @@ -1984,7 +1984,7 @@ QTreeWidgetItem *QTreeWidgetItem::takeChild(int index) Appends the given list of \a children to the item. - \sa insertChildren() takeChildren() + \sa insertChildren(), takeChildren() */ void QTreeWidgetItem::addChildren(const QList &children) { diff --git a/src/widgets/kernel/qaction.cpp b/src/widgets/kernel/qaction.cpp index f3455d34ad..0d500c81d6 100644 --- a/src/widgets/kernel/qaction.cpp +++ b/src/widgets/kernel/qaction.cpp @@ -571,7 +571,7 @@ bool QAction::autoRepeat() const By default, this property contains the application's default font. - \sa QAction::setText() QStyle + \sa QAction::setText(), QStyle */ void QAction::setFont(const QFont &font) { @@ -821,7 +821,7 @@ QString QAction::iconText() const By default, this property contains the action's text. - \sa setStatusTip() setShortcut() + \sa setStatusTip(), setShortcut() */ void QAction::setToolTip(const QString &tooltip) { @@ -853,7 +853,7 @@ QString QAction::toolTip() const By default, this property contains an empty string. - \sa setToolTip() showStatusText() + \sa setToolTip(), showStatusText() */ void QAction::setStatusTip(const QString &statustip) { @@ -1330,7 +1330,7 @@ QAction::SoftKeyRole QAction::softKeyRole() const For example: \snippet code/src_gui_kernel_qaction.cpp 0 - \sa QAction::icon QApplication::setAttribute() + \sa QAction::icon, QApplication::setAttribute() */ void QAction::setIconVisibleInMenu(bool visible) { diff --git a/src/widgets/kernel/qapplication.cpp b/src/widgets/kernel/qapplication.cpp index 60328c4cf6..fc6768efd0 100644 --- a/src/widgets/kernel/qapplication.cpp +++ b/src/widgets/kernel/qapplication.cpp @@ -2872,7 +2872,7 @@ void QApplication::setStartDragDistance(int l) The default value is 4 pixels. - \sa startDragTime() QPoint::manhattanLength() {Drag and Drop} + \sa startDragTime(), QPoint::manhattanLength(), {Drag and Drop} */ int QApplication::startDragDistance() diff --git a/src/widgets/kernel/qboxlayout.cpp b/src/widgets/kernel/qboxlayout.cpp index 46c51d1d37..66e887a078 100644 --- a/src/widgets/kernel/qboxlayout.cpp +++ b/src/widgets/kernel/qboxlayout.cpp @@ -1218,7 +1218,7 @@ void QBoxLayout::setDirection(Direction direction) Returns the direction of the box. addWidget() and addSpacing() work in this direction; the stretch stretches in this direction. - \sa QBoxLayout::Direction addWidget() addSpacing() + \sa QBoxLayout::Direction, addWidget(), addSpacing() */ QBoxLayout::Direction QBoxLayout::direction() const diff --git a/src/widgets/kernel/qwhatsthis.cpp b/src/widgets/kernel/qwhatsthis.cpp index c1a6ead381..39469ced98 100644 --- a/src/widgets/kernel/qwhatsthis.cpp +++ b/src/widgets/kernel/qwhatsthis.cpp @@ -541,7 +541,7 @@ QWhatsThis::QWhatsThis() When entering "What's This?" mode, a QEvent of type Qt::EnterWhatsThisMode is sent to all toplevel widgets. - \sa inWhatsThisMode() leaveWhatsThisMode() + \sa inWhatsThisMode(), leaveWhatsThisMode() */ void QWhatsThis::enterWhatsThisMode() { @@ -570,7 +570,7 @@ bool QWhatsThis::inWhatsThisMode() When leaving "What's This?" mode, a QEvent of type Qt::LeaveWhatsThisMode is sent to all toplevel widgets. - \sa enterWhatsThisMode() inWhatsThisMode() + \sa enterWhatsThisMode(), inWhatsThisMode() */ void QWhatsThis::leaveWhatsThisMode() { diff --git a/src/widgets/kernel/qwidget.cpp b/src/widgets/kernel/qwidget.cpp index 1b5b9ccf34..1f1e35a67d 100644 --- a/src/widgets/kernel/qwidget.cpp +++ b/src/widgets/kernel/qwidget.cpp @@ -2704,7 +2704,7 @@ bool QWidget::isMaximized() const combination of Qt::WindowState: Qt::WindowMinimized, Qt::WindowMaximized, Qt::WindowFullScreen, and Qt::WindowActive. - \sa Qt::WindowState setWindowState() + \sa Qt::WindowState, setWindowState() */ Qt::WindowStates QWidget::windowState() const { @@ -2753,7 +2753,7 @@ void QWidget::overrideWindowState(Qt::WindowStates newstate) When the window state changes, the widget receives a changeEvent() of type QEvent::WindowStateChange. - \sa Qt::WindowState windowState() + \sa Qt::WindowState, windowState() */ /*! @@ -2889,7 +2889,7 @@ void QWidget::showNormal() isEnabledTo(0) is equivalent to isEnabled(). - \sa setEnabled() enabled + \sa setEnabled(), enabled */ bool QWidget::isEnabledTo(const QWidget *ancestor) const @@ -3160,7 +3160,7 @@ void QWidget::setDisabled(bool disable) By default, this property contains a value that depends on the user's platform and screen geometry. - \sa geometry() x() y() pos() + \sa geometry(), x(), y(), pos() */ QRect QWidget::frameGeometry() const { @@ -3237,7 +3237,7 @@ int QWidget::y() const See the \l{Window Geometry} documentation for an overview of geometry issues with windows. - \sa frameGeometry, size x(), y() + \sa frameGeometry, size, x(), y() */ QPoint QWidget::pos() const { @@ -3384,7 +3384,7 @@ QRect QWidget::normalGeometry() const By default, for a widget with no children, this property contains a rectangle with zero width and height located at the origin. - \sa childrenRegion() geometry() + \sa childrenRegion(), geometry() */ QRect QWidget::childrenRect() const @@ -3408,7 +3408,7 @@ QRect QWidget::childrenRect() const By default, for a widget with no children, this property contains an empty region. - \sa childrenRect() geometry() mask() + \sa childrenRect(), geometry(), mask() */ QRegion QWidget::childrenRegion() const @@ -3824,7 +3824,7 @@ void QWidget::setMaximumHeight(int h) Sets both the minimum and maximum width of the widget to \a w without changing the heights. Provided for convenience. - \sa sizeHint() minimumSize() maximumSize() setFixedSize() + \sa sizeHint(), minimumSize(), maximumSize(), setFixedSize() */ void QWidget::setFixedWidth(int w) @@ -3844,7 +3844,7 @@ void QWidget::setFixedWidth(int w) Sets both the minimum and maximum heights of the widget to \a h without changing the widths. Provided for convenience. - \sa sizeHint() minimumSize() maximumSize() setFixedSize() + \sa sizeHint(), minimumSize(), maximumSize(), setFixedSize() */ void QWidget::setFixedHeight(int h) @@ -3865,7 +3865,7 @@ void QWidget::setFixedHeight(int h) of \a parent. The \a parent must not be 0 and must be a parent of the calling widget. - \sa mapFrom() mapToParent() mapToGlobal() underMouse() + \sa mapFrom(), mapToParent(), mapToGlobal(), underMouse() */ QPoint QWidget::mapTo(const QWidget * parent, const QPoint & pos) const @@ -3889,7 +3889,7 @@ QPoint QWidget::mapTo(const QWidget * parent, const QPoint & pos) const of \a parent to this widget's coordinate system. The \a parent must not be 0 and must be a parent of the calling widget. - \sa mapTo() mapFromParent() mapFromGlobal() underMouse() + \sa mapTo(), mapFromParent(), mapFromGlobal(), underMouse() */ QPoint QWidget::mapFrom(const QWidget * parent, const QPoint & pos) const @@ -3915,7 +3915,7 @@ QPoint QWidget::mapFrom(const QWidget * parent, const QPoint & pos) const Same as mapToGlobal() if the widget has no parent. - \sa mapFromParent() mapTo() mapToGlobal() underMouse() + \sa mapFromParent(), mapTo(), mapToGlobal(), underMouse() */ QPoint QWidget::mapToParent(const QPoint &pos) const @@ -3929,7 +3929,7 @@ QPoint QWidget::mapToParent(const QPoint &pos) const Same as mapFromGlobal() if the widget has no parent. - \sa mapToParent() mapFrom() mapFromGlobal() underMouse() + \sa mapToParent(), mapFrom(), mapFromGlobal(), underMouse() */ QPoint QWidget::mapFromParent(const QPoint &pos) const @@ -5420,7 +5420,7 @@ QGraphicsProxyWidget * QWidgetPrivate::nearestGraphicsProxyWidget(const QWidget If the widget displays dates or numbers, these should be formatted using the widget's locale. - \sa QLocale QLocale::setDefault() + \sa QLocale, QLocale::setDefault() */ void QWidgetPrivate::setLocale_helper(const QLocale &loc, bool forceUpdate) @@ -6839,7 +6839,7 @@ QRect QWidget::contentsRect() const \link QAbstractScrollArea::viewport() viewport() \endlink . - \sa mapToGlobal() QMenu contextMenuPolicy + \sa mapToGlobal(), QMenu, contextMenuPolicy */ @@ -7572,7 +7572,7 @@ bool QWidget::close() isVisibleTo(0) is identical to isVisible(). - \sa show() hide() isVisible() + \sa show(), hide(), isVisible() */ bool QWidget::isVisibleTo(const QWidget *ancestor) const @@ -8436,7 +8436,7 @@ void QWidget::mouseReleaseEvent(QMouseEvent *event) developer to ensure that the application interprets these events correctly. - \sa mousePressEvent(), mouseReleaseEvent() mouseMoveEvent(), + \sa mousePressEvent(), mouseReleaseEvent(), mouseMoveEvent(), event(), QMouseEvent */ @@ -8776,7 +8776,7 @@ void QWidget::closeEvent(QCloseEvent *event) The default implementation ignores the context event. See the \l QContextMenuEvent documentation for more details. - \sa event(), QContextMenuEvent customContextMenuRequested() + \sa event(), QContextMenuEvent, customContextMenuRequested() */ void QWidget::contextMenuEvent(QContextMenuEvent *event) @@ -9211,7 +9211,7 @@ QLayout *QWidget::takeLayout() use additional space, and that they can make do with less than sizeHint(). - \sa sizeHint() QLayout QSizePolicy updateGeometry() + \sa sizeHint(), QLayout, QSizePolicy, updateGeometry() */ QSizePolicy QWidget::sizePolicy() const { @@ -9844,7 +9844,7 @@ void QWidget::repaint(const QRegion &rgn) If the Qt::WA_OpaquePaintEvent widget attribute is set, the widget is responsible for painting all its pixels with an opaque color. - \sa repaint() paintEvent(), setUpdatesEnabled(), {Analog Clock Example} + \sa repaint(), paintEvent(), setUpdatesEnabled(), {Analog Clock Example} */ void QWidget::update() { @@ -10357,7 +10357,7 @@ void QWidgetPrivate::setWindowModified_helper() By default, this property contains an empty string. - \sa QToolTip statusTip whatsThis + \sa QToolTip, statusTip, whatsThis */ void QWidget::setToolTip(const QString &s) { @@ -10383,7 +10383,7 @@ QString QWidget::toolTip() const By default, this property contains an empty string. - \sa toolTip whatsThis + \sa toolTip, whatsThis */ void QWidget::setStatusTip(const QString &s) { @@ -10406,7 +10406,7 @@ QString QWidget::statusTip() const By default, this property contains an empty string. - \sa QWhatsThis QWidget::toolTip QWidget::statusTip + \sa QWhatsThis, QWidget::toolTip, QWidget::statusTip */ void QWidget::setWhatsThis(const QString &s) { @@ -10494,7 +10494,7 @@ QString QWidget::accessibleDescription() const key sequence, so are much easier to use than this low-level function. - \sa releaseShortcut() setShortcutEnabled() + \sa releaseShortcut(), setShortcutEnabled() */ int QWidget::grabShortcut(const QKeySequence &key, Qt::ShortcutContext context) { @@ -10518,7 +10518,7 @@ int QWidget::grabShortcut(const QKeySequence &key, Qt::ShortcutContext context) this low-level function. Note also that this is an expensive operation. - \sa grabShortcut() setShortcutEnabled() + \sa grabShortcut(), setShortcutEnabled() */ void QWidget::releaseShortcut(int id) { @@ -10537,7 +10537,7 @@ void QWidget::releaseShortcut(int id) to use QAction or QShortcut to handle shortcuts, since they are easier to use than this low-level function. - \sa grabShortcut() releaseShortcut() + \sa grabShortcut(), releaseShortcut() */ void QWidget::setShortcutEnabled(int id, bool enable) { @@ -10552,7 +10552,7 @@ void QWidget::setShortcutEnabled(int id, bool enable) If \a enable is true, auto repeat of the shortcut with the given \a id is enabled; otherwise it is disabled. - \sa grabShortcut() releaseShortcut() + \sa grabShortcut(), releaseShortcut() */ void QWidget::setShortcutAutoRepeat(int id, bool enable) { @@ -11093,7 +11093,7 @@ void QWidget::ungrabGesture(Qt::GestureType gesture) coordinates. For example, \c{mapToGlobal(QPoint(0,0))} would give the global coordinates of the top-left pixel of the widget. - \sa mapFromGlobal() mapTo() mapToParent() + \sa mapFromGlobal(), mapTo(), mapToParent() */ /*! @@ -11102,7 +11102,7 @@ void QWidget::ungrabGesture(Qt::GestureType gesture) Translates the global screen coordinate \a pos to widget coordinates. - \sa mapToGlobal() mapFrom() mapFromParent() + \sa mapToGlobal(), mapFrom(), mapFromParent() */ /*! @@ -11132,7 +11132,7 @@ void QWidget::ungrabGesture(Qt::GestureType gesture) frame of that widget. For \e Carbon, it works outside the widget's frame as well, like for Windows and X11. - \sa releaseMouse() grabKeyboard() releaseKeyboard() + \sa releaseMouse(), grabKeyboard(), releaseKeyboard() */ /*! @@ -11177,7 +11177,7 @@ void QWidget::ungrabGesture(Qt::GestureType gesture) If a different widget is currently grabbing keyboard input, that widget's grab is released first. - \sa releaseKeyboard() grabMouse() releaseMouse() focusWidget() + \sa releaseKeyboard(), grabMouse(), releaseMouse(), focusWidget() */ /*! diff --git a/src/widgets/styles/qmacstyle.qdoc b/src/widgets/styles/qmacstyle.qdoc index dc8da491bf..96b3a78b06 100644 --- a/src/widgets/styles/qmacstyle.qdoc +++ b/src/widgets/styles/qmacstyle.qdoc @@ -167,7 +167,7 @@ to its default value, you must save the old value of the attribute before you change it. - \sa focusRectPolicy() QWidget::setAttribute() + \sa focusRectPolicy(), QWidget::setAttribute() */ /*! \fn QMacStyle::FocusRectPolicy QMacStyle::focusRectPolicy(const QWidget *w) diff --git a/src/widgets/styles/qstyle.cpp b/src/widgets/styles/qstyle.cpp index b4f24acf84..21183531a5 100644 --- a/src/widgets/styles/qstyle.cpp +++ b/src/widgets/styles/qstyle.cpp @@ -1088,7 +1088,7 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment, \value CC_CustomBase Base value for custom complex controls. Custom values must be greater than this value. - \sa SubControl drawComplexControl() + \sa SubControl, drawComplexControl() */ /*! @@ -1536,7 +1536,7 @@ void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment, \row \li \l CT_MenuItem \li \l QStyleOptionMenuItem \endtable - \sa ContentsType QStyleOption + \sa ContentsType, QStyleOption */ /*! diff --git a/src/widgets/styles/qstyleoption.cpp b/src/widgets/styles/qstyleoption.cpp index 1da5d786c7..8486a06465 100644 --- a/src/widgets/styles/qstyleoption.cpp +++ b/src/widgets/styles/qstyleoption.cpp @@ -2098,7 +2098,7 @@ QStyleOptionSlider::QStyleOptionSlider(int version) The default value is 0. - \sa QAbstractSlider::tracking sliderPosition + \sa QAbstractSlider::tracking, sliderPosition */ /*! diff --git a/src/widgets/util/qsystemtrayicon.cpp b/src/widgets/util/qsystemtrayicon.cpp index fc2d046114..b3af2798fb 100644 --- a/src/widgets/util/qsystemtrayicon.cpp +++ b/src/widgets/util/qsystemtrayicon.cpp @@ -381,7 +381,7 @@ bool QSystemTrayIcon::supportsMessages() On Mac OS X, the Growl notification system must be installed for this function to display messages. - \sa show() supportsMessages() + \sa show(), supportsMessages() */ void QSystemTrayIcon::showMessage(const QString& title, const QString& msg, QSystemTrayIcon::MessageIcon icon, int msecs) diff --git a/src/widgets/util/qundogroup.cpp b/src/widgets/util/qundogroup.cpp index c08c824bdf..cf7d826b3b 100644 --- a/src/widgets/util/qundogroup.cpp +++ b/src/widgets/util/qundogroup.cpp @@ -128,7 +128,7 @@ QUndoGroup::~QUndoGroup() QObject in QUndoStack::QUndoStack(). In this case, the stack is deleted when the group is deleted, in the usual manner of QObjects. - \sa removeStack() stacks() QUndoStack::QUndoStack() + \sa removeStack(), stacks(), QUndoStack::QUndoStack() */ void QUndoGroup::addStack(QUndoStack *stack) @@ -148,7 +148,7 @@ void QUndoGroup::addStack(QUndoStack *stack) Removes \a stack from this group. If the stack was the active stack in the group, the active stack becomes 0. - \sa addStack() stacks() QUndoStack::~QUndoStack() + \sa addStack(), stacks(), QUndoStack::~QUndoStack() */ void QUndoGroup::removeStack(QUndoStack *stack) @@ -165,7 +165,7 @@ void QUndoGroup::removeStack(QUndoStack *stack) /*! Returns a list of stacks in this group. - \sa addStack() removeStack() + \sa addStack(), removeStack() */ QList QUndoGroup::stacks() const @@ -185,7 +185,7 @@ QList QUndoGroup::stacks() const in the same way as those returned by \a stack's QUndoStack::createUndoAction() and QUndoStack::createRedoAction(). - \sa QUndoStack::setActive() activeStack() + \sa QUndoStack::setActive(), activeStack() */ void QUndoGroup::setActiveStack(QUndoStack *stack) @@ -248,7 +248,7 @@ void QUndoGroup::setActiveStack(QUndoStack *stack) If none of the stacks are active, or if the group is empty, this function returns 0. - \sa setActiveStack() QUndoStack::setActive() + \sa setActiveStack(), QUndoStack::setActive() */ QUndoStack *QUndoGroup::activeStack() const @@ -263,7 +263,7 @@ QUndoStack *QUndoGroup::activeStack() const If none of the stacks are active, or if the group is empty, this function does nothing. - \sa redo() canUndo() setActiveStack() + \sa redo(), canUndo(), setActiveStack() */ void QUndoGroup::undo() @@ -279,7 +279,7 @@ void QUndoGroup::undo() If none of the stacks are active, or if the group is empty, this function does nothing. - \sa undo() canRedo() setActiveStack() + \sa undo(), canRedo(), setActiveStack() */ @@ -296,7 +296,7 @@ void QUndoGroup::redo() If none of the stacks are active, or if the group is empty, this function returns false. - \sa canRedo() setActiveStack() + \sa canRedo(), setActiveStack() */ bool QUndoGroup::canUndo() const @@ -311,7 +311,7 @@ bool QUndoGroup::canUndo() const If none of the stacks are active, or if the group is empty, this function returns false. - \sa canUndo() setActiveStack() + \sa canUndo(), setActiveStack() */ bool QUndoGroup::canRedo() const @@ -326,7 +326,7 @@ bool QUndoGroup::canRedo() const If none of the stacks are active, or if the group is empty, this function returns an empty string. - \sa redoText() setActiveStack() + \sa redoText(), setActiveStack() */ QString QUndoGroup::undoText() const @@ -341,7 +341,7 @@ QString QUndoGroup::undoText() const If none of the stacks are active, or if the group is empty, this function returns an empty string. - \sa undoText() setActiveStack() + \sa undoText(), setActiveStack() */ QString QUndoGroup::redoText() const @@ -379,7 +379,7 @@ bool QUndoGroup::isClean() const If \a prefix is empty, the default template "Undo %1" is used instead of prefix. Before Qt 4.8, the prefix "Undo" was used by default. - \sa createRedoAction() canUndo() QUndoCommand::text() + \sa createRedoAction(), canUndo(), QUndoCommand::text() */ QAction *QUndoGroup::createUndoAction(QObject *parent, const QString &prefix) const @@ -410,7 +410,7 @@ QAction *QUndoGroup::createUndoAction(QObject *parent, const QString &prefix) co If \a prefix is empty, the default template "Redo %1" is used instead of prefix. Before Qt 4.8, the prefix "Redo" was used by default. - \sa createUndoAction() canRedo() QUndoCommand::text() + \sa createUndoAction(), canRedo(), QUndoCommand::text() */ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) const @@ -438,7 +438,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co is removed form the group. \a stack is the new active stack. If no stack is active, \a stack is 0. - \sa setActiveStack() QUndoStack::setActive() + \sa setActiveStack(), QUndoStack::setActive() */ /*! \fn void QUndoGroup::indexChanged(int idx) @@ -448,7 +448,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co \a idx is the new current index, or 0 if the active stack is 0. - \sa QUndoStack::indexChanged() setActiveStack() + \sa QUndoStack::indexChanged(), setActiveStack() */ /*! \fn void QUndoGroup::cleanChanged(bool clean) @@ -458,7 +458,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co \a clean is the new state, or true if the active stack is 0. - \sa QUndoStack::cleanChanged() setActiveStack() + \sa QUndoStack::cleanChanged(), setActiveStack() */ /*! \fn void QUndoGroup::canUndoChanged(bool canUndo) @@ -468,7 +468,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co \a canUndo is the new state, or false if the active stack is 0. - \sa QUndoStack::canUndoChanged() setActiveStack() + \sa QUndoStack::canUndoChanged(), setActiveStack() */ /*! \fn void QUndoGroup::canRedoChanged(bool canRedo) @@ -478,7 +478,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co \a canRedo is the new state, or false if the active stack is 0. - \sa QUndoStack::canRedoChanged() setActiveStack() + \sa QUndoStack::canRedoChanged(), setActiveStack() */ /*! \fn void QUndoGroup::undoTextChanged(const QString &undoText) @@ -488,7 +488,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co \a undoText is the new state, or an empty string if the active stack is 0. - \sa QUndoStack::undoTextChanged() setActiveStack() + \sa QUndoStack::undoTextChanged(), setActiveStack() */ /*! \fn void QUndoGroup::redoTextChanged(const QString &redoText) @@ -498,7 +498,7 @@ QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix) co \a redoText is the new state, or an empty string if the active stack is 0. - \sa QUndoStack::redoTextChanged() setActiveStack() + \sa QUndoStack::redoTextChanged(), setActiveStack() */ QT_END_NAMESPACE diff --git a/src/widgets/util/qundostack.cpp b/src/widgets/util/qundostack.cpp index 3951017f89..47e161f059 100644 --- a/src/widgets/util/qundostack.cpp +++ b/src/widgets/util/qundostack.cpp @@ -184,7 +184,7 @@ int QUndoCommand::id() const \snippet code/src_gui_util_qundostack.cpp 3 - \sa id() QUndoStack::push() + \sa id(), QUndoStack::push() */ bool QUndoCommand::mergeWith(const QUndoCommand *command) @@ -271,7 +271,7 @@ QString QUndoCommand::actionText() const different strings in order to match specific languages' needs. The described feature and the function actionText() are available since Qt 4.8. - \sa text() actionText() QUndoStack::createUndoAction() QUndoStack::createRedoAction() + \sa text(), actionText(), QUndoStack::createUndoAction(), QUndoStack::createRedoAction() */ void QUndoCommand::setText(const QString &text) @@ -578,7 +578,7 @@ void QUndoStack::clear() been executed will almost always lead to corruption of the document's state. - \sa QUndoCommand::id() QUndoCommand::mergeWith() + \sa QUndoCommand::id(), QUndoCommand::mergeWith() */ void QUndoStack::push(QUndoCommand *cmd) @@ -652,7 +652,7 @@ void QUndoStack::setClean() /*! If the stack is in the clean state, returns true; otherwise returns false. - \sa setClean() cleanIndex() + \sa setClean(), cleanIndex() */ bool QUndoStack::isClean() const @@ -671,7 +671,7 @@ bool QUndoStack::isClean() const push() deletes all the undone commands before pushing the new command, the stack can't return to the clean state again. In this case, this function returns -1. - \sa isClean() setClean() + \sa isClean(), setClean() */ int QUndoStack::cleanIndex() const @@ -687,7 +687,7 @@ int QUndoStack::cleanIndex() const If the stack is empty, or if the bottom command on the stack has already been undone, this function does nothing. - \sa redo() index() + \sa redo(), index() */ void QUndoStack::undo() @@ -713,7 +713,7 @@ void QUndoStack::undo() If the stack is empty, or if the top command on the stack has already been redone, this function does nothing. - \sa undo() index() + \sa undo(), index() */ void QUndoStack::redo() @@ -735,7 +735,7 @@ void QUndoStack::redo() Returns the number of commands on the stack. Macro commands are counted as one command. - \sa index() setIndex() command() + \sa index(), setIndex(), command() */ int QUndoStack::count() const @@ -749,7 +749,7 @@ int QUndoStack::count() const executed on the next call to redo(). It is not always the top-most command on the stack, since a number of commands may have been undone. - \sa undo() redo() count() + \sa undo(), redo(), count() */ int QUndoStack::index() const @@ -763,7 +763,7 @@ int QUndoStack::index() const \a idx. This function can be used to roll the state of the document forwards of backwards. indexChanged() is emitted only once. - \sa index() count() undo() redo() + \sa index(), count(), undo(), redo() */ void QUndoStack::setIndex(int idx) @@ -796,7 +796,7 @@ void QUndoStack::setIndex(int idx) Synonymous with index() == 0. - \sa index() canRedo() + \sa index(), canRedo() */ bool QUndoStack::canUndo() const @@ -815,7 +815,7 @@ bool QUndoStack::canUndo() const Synonymous with index() == count(). - \sa index() canUndo() + \sa index(), canUndo() */ bool QUndoStack::canRedo() const @@ -829,7 +829,7 @@ bool QUndoStack::canRedo() const /*! Returns the text of the command which will be undone in the next call to undo(). - \sa QUndoCommand::actionText() redoText() + \sa QUndoCommand::actionText(), redoText() */ QString QUndoStack::undoText() const @@ -845,7 +845,7 @@ QString QUndoStack::undoText() const /*! Returns the text of the command which will be redone in the next call to redo(). - \sa QUndoCommand::actionText() undoText() + \sa QUndoCommand::actionText(), undoText() */ QString QUndoStack::redoText() const @@ -1129,7 +1129,7 @@ bool QUndoStack::isActive() const \a idx specifies the index of the current command, ie. the command which will be executed on the next call to redo(). - \sa index() setIndex() + \sa index(), setIndex() */ /*! @@ -1139,7 +1139,7 @@ bool QUndoStack::isActive() const If \a clean is true, the stack is in a clean state; otherwise this signal indicates that it has left the clean state. - \sa isClean() setClean() + \sa isClean(), setClean() */ /*! diff --git a/src/widgets/util/qundoview.cpp b/src/widgets/util/qundoview.cpp index a87e9e0f05..2a88b50917 100644 --- a/src/widgets/util/qundoview.cpp +++ b/src/widgets/util/qundoview.cpp @@ -350,7 +350,7 @@ QUndoView::~QUndoView() Returns the stack currently displayed by this view. If the view is looking at a QUndoGroup, this the group's active stack. - \sa setStack() setGroup() + \sa setStack(), setGroup() */ QUndoStack *QUndoView::stack() const @@ -365,7 +365,7 @@ QUndoStack *QUndoView::stack() const If the view was previously looking at a QUndoGroup, the group is set to 0. - \sa stack() setGroup() + \sa stack(), setGroup() */ void QUndoView::setStack(QUndoStack *stack) @@ -385,7 +385,7 @@ void QUndoView::setStack(QUndoStack *stack) The view will update itself autmiatically whenever the active stack of the group changes. - \sa group() setStack() + \sa group(), setStack() */ void QUndoView::setGroup(QUndoGroup *group) @@ -416,7 +416,7 @@ void QUndoView::setGroup(QUndoGroup *group) If the view is not looking at group, this function returns 0. - \sa setGroup() setStack() + \sa setGroup(), setStack() */ QUndoGroup *QUndoView::group() const diff --git a/src/widgets/widgets/qabstractslider.cpp b/src/widgets/widgets/qabstractslider.cpp index c73da4e8c4..bab17c4173 100644 --- a/src/widgets/widgets/qabstractslider.cpp +++ b/src/widgets/widgets/qabstractslider.cpp @@ -171,7 +171,7 @@ QT_BEGIN_NAMESPACE This signal is emitted when the user releases the slider with the mouse, or programmatically when setSliderDown(false) is called. - \sa sliderPressed() sliderMoved() sliderDown + \sa sliderPressed(), sliderMoved(), sliderDown */ /*! @@ -238,7 +238,7 @@ QAbstractSliderPrivate::~QAbstractSliderPrivate() If \a max is smaller than \a min, \a min becomes the only legal value. - \sa minimum maximum + \sa minimum, maximum */ void QAbstractSlider::setRange(int min, int max) { diff --git a/src/widgets/widgets/qbuttongroup.cpp b/src/widgets/widgets/qbuttongroup.cpp index a5e96370cf..56dbad15b2 100644 --- a/src/widgets/widgets/qbuttongroup.cpp +++ b/src/widgets/widgets/qbuttongroup.cpp @@ -82,7 +82,7 @@ of the mapping mechanism is to simplify the representation of enum values in a user interface. - \sa QGroupBox QPushButton, QCheckBox, QRadioButton + \sa QGroupBox, QPushButton, QCheckBox, QRadioButton */ /*! @@ -90,7 +90,7 @@ Constructs a new, empty button group with the given \a parent. - \sa addButton() setExclusive() + \sa addButton(), setExclusive() */ /*! @@ -183,7 +183,7 @@ starting with -2. If you are assigning your own ids, use positive values to avoid conflicts. - \sa removeButton() buttons() + \sa removeButton(), buttons() */ /*! @@ -191,7 +191,7 @@ Removes the given \a button from the button group. - \sa addButton() buttons() + \sa addButton(), buttons() */ /*! diff --git a/src/widgets/widgets/qcheckbox.cpp b/src/widgets/widgets/qcheckbox.cpp index a0093800a5..8c90494f92 100644 --- a/src/widgets/widgets/qcheckbox.cpp +++ b/src/widgets/widgets/qcheckbox.cpp @@ -233,7 +233,7 @@ bool QCheckBox::isTristate() const Returns the check box's check state. If you do not need tristate support, you can also use \l QAbstractButton::isChecked() which returns a boolean. - \sa setCheckState() Qt::CheckState + \sa setCheckState(), Qt::CheckState */ Qt::CheckState QCheckBox::checkState() const { @@ -248,7 +248,7 @@ Qt::CheckState QCheckBox::checkState() const support, you can also use \l QAbstractButton::setChecked() which takes a boolean. - \sa checkState() Qt::CheckState + \sa checkState(), Qt::CheckState */ void QCheckBox::setCheckState(Qt::CheckState state) { diff --git a/src/widgets/widgets/qcommandlinkbutton.cpp b/src/widgets/widgets/qcommandlinkbutton.cpp index e392aaa1a5..d2af2ddd17 100644 --- a/src/widgets/widgets/qcommandlinkbutton.cpp +++ b/src/widgets/widgets/qcommandlinkbutton.cpp @@ -70,7 +70,7 @@ QT_BEGIN_NAMESPACE By default it will also carry an arrow icon, indicating that pressing the control will open another window or page. - \sa QPushButton QRadioButton + \sa QPushButton, QRadioButton */ /*! diff --git a/src/widgets/widgets/qdialogbuttonbox.cpp b/src/widgets/widgets/qdialogbuttonbox.cpp index bcf0753d33..602a004220 100644 --- a/src/widgets/widgets/qdialogbuttonbox.cpp +++ b/src/widgets/widgets/qdialogbuttonbox.cpp @@ -874,7 +874,7 @@ QDialogButtonBox::~QDialogButtonBox() This signal is emitted when a button inside the button box is clicked, as long as it was defined with the \l AcceptRole or \l YesRole. - \sa rejected(), clicked() helpRequested() + \sa rejected(), clicked(), helpRequested() */ /*! @@ -883,7 +883,7 @@ QDialogButtonBox::~QDialogButtonBox() This signal is emitted when a button inside the button box is clicked, as long as it was defined with the \l RejectRole or \l NoRole. - \sa accepted() helpRequested() clicked() + \sa accepted(), helpRequested(), clicked() */ /*! @@ -892,7 +892,7 @@ QDialogButtonBox::~QDialogButtonBox() This signal is emitted when a button inside the button box is clicked, as long as it was defined with the \l HelpRole. - \sa accepted() rejected() clicked() + \sa accepted(), rejected(), clicked() */ /*! diff --git a/src/widgets/widgets/qdockwidget.cpp b/src/widgets/widgets/qdockwidget.cpp index db45bf4e46..7f354a8f99 100644 --- a/src/widgets/widgets/qdockwidget.cpp +++ b/src/widgets/widgets/qdockwidget.cpp @@ -1471,7 +1471,7 @@ bool QDockWidget::event(QEvent *event) The action's text is set to the dock widget's window title. - \sa QAction::text QWidget::windowTitle + \sa QAction::text, QWidget::windowTitle */ QAction * QDockWidget::toggleViewAction() const { @@ -1562,7 +1562,7 @@ QAction * QDockWidget::toggleViewAction() const to its parent QDockWidget. Hence it can perform such operations as docking and hiding in response to user actions. - \sa titleBarWidget() DockWidgetVerticalTitleBar + \sa titleBarWidget(), DockWidgetVerticalTitleBar */ void QDockWidget::setTitleBarWidget(QWidget *widget) diff --git a/src/widgets/widgets/qframe.cpp b/src/widgets/widgets/qframe.cpp index d11ff09a30..6c37ad8c01 100644 --- a/src/widgets/widgets/qframe.cpp +++ b/src/widgets/widgets/qframe.cpp @@ -150,7 +150,7 @@ inline void QFramePrivate::init() the lineWidth() and the midLineWidth() to create the total result. See the picture of the frames in the main class documentation. - \sa QFrame::Shadow QFrame::style() QStyle::drawPrimitive() + \sa QFrame::Shadow, QFrame::style(), QStyle::drawPrimitive() */ @@ -175,7 +175,7 @@ inline void QFramePrivate::init() midLineWidth(). See the picture of the frames in the main class documentation. - \sa QFrame::Shape lineWidth() midLineWidth() + \sa QFrame::Shape, lineWidth(), midLineWidth() */ /*! diff --git a/src/widgets/widgets/qlineedit.cpp b/src/widgets/widgets/qlineedit.cpp index bbf34b9853..cd3019b720 100644 --- a/src/widgets/widgets/qlineedit.cpp +++ b/src/widgets/widgets/qlineedit.cpp @@ -366,7 +366,7 @@ void QLineEdit::setPlaceholderText(const QString& placeholderText) By default, this property contains an empty string. - \sa setEchoMode() text() EchoMode + \sa setEchoMode(), text(), EchoMode */ QString QLineEdit::displayText() const @@ -445,7 +445,7 @@ void QLineEdit::setFrame(bool enable) \value PasswordEchoOnEdit Display characters as they are entered while editing otherwise display asterisks. - \sa setEchoMode() echoMode() + \sa setEchoMode(), echoMode() */ @@ -466,7 +466,7 @@ void QLineEdit::setFrame(bool enable) By default, this property is set to \l Normal. - \sa EchoMode displayText() + \sa EchoMode, displayText() */ QLineEdit::EchoMode QLineEdit::echoMode() const @@ -524,7 +524,7 @@ const QValidator * QLineEdit::validator() const The initial setting is to have no input validator (i.e. any input is accepted up to maxLength()). - \sa validator() QIntValidator QDoubleValidator QRegExpValidator + \sa validator(), QIntValidator, QDoubleValidator, QRegExpValidator */ void QLineEdit::setValidator(const QValidator *v) @@ -901,7 +901,7 @@ int QLineEdit::selectionStart() const Selects text from position \a start and for \a length characters. Negative lengths are allowed. - \sa deselect() selectAll() selectedText() + \sa deselect(), selectAll(), selectedText() */ void QLineEdit::setSelection(int start, int length) @@ -1159,7 +1159,7 @@ void QLineEdit::setInputMask(const QString &inputMask) because if the user types before clicking on the widget, the selected text will be deleted. - \sa setSelection() deselect() + \sa setSelection(), deselect() */ void QLineEdit::selectAll() @@ -1171,7 +1171,7 @@ void QLineEdit::selectAll() /*! Deselects any selected text. - \sa setSelection() selectAll() + \sa setSelection(), selectAll() */ void QLineEdit::deselect() @@ -1276,7 +1276,7 @@ void QLineEdit::setReadOnly(bool enable) If the current validator disallows deleting the selected text, cut() will copy without deleting. - \sa copy() paste() setValidator() + \sa copy(), paste(), setValidator() */ void QLineEdit::cut() @@ -1292,7 +1292,7 @@ void QLineEdit::cut() Copies the selected text to the clipboard, if there is any, and if echoMode() is \l Normal. - \sa cut() paste() + \sa cut(), paste() */ void QLineEdit::copy() const @@ -1309,7 +1309,7 @@ void QLineEdit::copy() const If the end result would not be acceptable to the current \link setValidator() validator\endlink, nothing happens. - \sa copy() cut() + \sa copy(), cut() */ void QLineEdit::paste() diff --git a/src/widgets/widgets/qmainwindow.cpp b/src/widgets/widgets/qmainwindow.cpp index efd5db07ab..22be289aac 100644 --- a/src/widgets/widgets/qmainwindow.cpp +++ b/src/widgets/widgets/qmainwindow.cpp @@ -718,7 +718,7 @@ void QMainWindow::removeToolBarBreak(QToolBar *before) bar block (i.e. line). If the main window already manages \a toolbar then it will only move the toolbar to \a area. - \sa insertToolBar() addToolBarBreak() insertToolBarBreak() + \sa insertToolBar(), addToolBarBreak(), insertToolBarBreak() */ void QMainWindow::addToolBar(Qt::ToolBarArea area, QToolBar *toolbar) { @@ -788,7 +788,7 @@ QToolBar *QMainWindow::addToolBar(const QString &title) layout operation, this means that \a toolbar will appear to the left of the toolbar specified by \a before in a horizontal toolbar area. - \sa insertToolBarBreak() addToolBar() addToolBarBreak() + \sa insertToolBarBreak(), addToolBar(), addToolBarBreak() */ void QMainWindow::insertToolBar(QToolBar *before, QToolBar *toolbar) { @@ -823,7 +823,7 @@ void QMainWindow::removeToolBar(QToolBar *toolbar) been added to the main window, this function returns \c Qt::NoToolBarArea. - \sa addToolBar() addToolBarBreak() Qt::ToolBarArea + \sa addToolBar(), addToolBarBreak(), Qt::ToolBarArea */ Qt::ToolBarArea QMainWindow::toolBarArea(QToolBar *toolbar) const { return d_func()->layout->toolBarArea(toolbar); } @@ -833,7 +833,7 @@ Qt::ToolBarArea QMainWindow::toolBarArea(QToolBar *toolbar) const Returns whether there is a toolbar break before the \a toolbar. - \sa addToolBarBreak(), insertToolBarBreak() + \sa addToolBarBreak(), insertToolBarBreak() */ bool QMainWindow::toolBarBreak(QToolBar *toolbar) const { @@ -1191,7 +1191,7 @@ void QMainWindow::removeDockWidget(QDockWidget *dockwidget) has not been added to the main window, this function returns \c Qt::NoDockWidgetArea. - \sa addDockWidget() splitDockWidget() Qt::DockWidgetArea + \sa addDockWidget(), splitDockWidget(), Qt::DockWidgetArea */ Qt::DockWidgetArea QMainWindow::dockWidgetArea(QDockWidget *dockwidget) const { return d_func()->layout->dockWidgetArea(dockwidget); } diff --git a/src/widgets/widgets/qmenu.cpp b/src/widgets/widgets/qmenu.cpp index 955e2e5c8c..995edcbbbc 100644 --- a/src/widgets/widgets/qmenu.cpp +++ b/src/widgets/widgets/qmenu.cpp @@ -1140,7 +1140,7 @@ bool QMenuPrivate::hasMouseMoved(const QPoint &globalPos) is useful for subclasses when they need a QStyleOptionMenuItem, but don't want to fill in all the information themselves. - \sa QStyleOption::initFrom() QMenuBar::initStyleOption() + \sa QStyleOption::initFrom(), QMenuBar::initStyleOption() */ void QMenu::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const { @@ -1444,7 +1444,7 @@ QAction *QMenu::addAction(const QIcon &icon, const QString &text, const QObject It returns \a menu's menuAction(). This menu does not take ownership of \a menu. - \sa QWidget::addAction() QMenu::menuAction() + \sa QWidget::addAction(), QMenu::menuAction() */ QAction *QMenu::addMenu(QMenu *menu) { @@ -1457,7 +1457,7 @@ QAction *QMenu::addMenu(QMenu *menu) Appends a new QMenu with \a title to the menu. The menu takes ownership of the menu. Returns the new menu. - \sa QWidget::addAction() QMenu::menuAction() + \sa QWidget::addAction(), QMenu::menuAction() */ QMenu *QMenu::addMenu(const QString &title) { @@ -1470,7 +1470,7 @@ QMenu *QMenu::addMenu(const QString &title) Appends a new QMenu with \a icon and \a title to the menu. The menu takes ownership of the menu. Returns the new menu. - \sa QWidget::addAction() QMenu::menuAction() + \sa QWidget::addAction(), QMenu::menuAction() */ QMenu *QMenu::addMenu(const QIcon &icon, const QString &title) { @@ -1584,7 +1584,7 @@ bool QMenu::isTearOffEnabled() const contents in a new window. When the menu is in this mode and the menu is visible returns true; otherwise false. - \sa hideTearOffMenu() isTearOffEnabled() + \sa hideTearOffMenu(), isTearOffEnabled() */ bool QMenu::isTearOffMenuVisible() const { @@ -1597,7 +1597,7 @@ bool QMenu::isTearOffMenuVisible() const This function will forcibly hide the torn off menu making it disappear from the users desktop. - \sa isTearOffMenuVisible() isTearOffEnabled() + \sa isTearOffMenuVisible(), isTearOffEnabled() */ void QMenu::hideTearOffMenu() { diff --git a/src/widgets/widgets/qmenubar.cpp b/src/widgets/widgets/qmenubar.cpp index 80b6faa1a0..7c1e6b9166 100644 --- a/src/widgets/widgets/qmenubar.cpp +++ b/src/widgets/widgets/qmenubar.cpp @@ -547,7 +547,7 @@ void QMenuBarPrivate::_q_actionHovered() is useful for subclasses when they need a QStyleOptionMenuItem, but don't want to fill in all the information themselves. - \sa QStyleOption::initFrom() QMenu::initStyleOption() + \sa QStyleOption::initFrom(), QMenu::initStyleOption() */ void QMenuBar::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const { @@ -831,7 +831,7 @@ QAction *QMenuBar::addAction(const QString &text, const QObject *receiver, const Appends a new QMenu with \a title to the menu bar. The menu bar takes ownership of the menu. Returns the new menu. - \sa QWidget::addAction() QMenu::menuAction() + \sa QWidget::addAction(), QMenu::menuAction() */ QMenu *QMenuBar::addMenu(const QString &title) { @@ -844,7 +844,7 @@ QMenu *QMenuBar::addMenu(const QString &title) Appends a new QMenu with \a icon and \a title to the menu bar. The menu bar takes ownership of the menu. Returns the new menu. - \sa QWidget::addAction() QMenu::menuAction() + \sa QWidget::addAction(), QMenu::menuAction() */ QMenu *QMenuBar::addMenu(const QIcon &icon, const QString &title) { @@ -860,7 +860,7 @@ QMenu *QMenuBar::addMenu(const QIcon &icon, const QString &title) \note The returned QAction object can be used to hide the corresponding menu. - \sa QWidget::addAction() QMenu::menuAction() + \sa QWidget::addAction(), QMenu::menuAction() */ QAction *QMenuBar::addMenu(QMenu *menu) { @@ -900,7 +900,7 @@ QAction *QMenuBar::insertSeparator(QAction *before) This convenience function inserts \a menu before action \a before and returns the menus menuAction(). - \sa QWidget::insertAction() addMenu() + \sa QWidget::insertAction(), addMenu() */ QAction *QMenuBar::insertMenu(QAction *before, QMenu *menu) { diff --git a/src/widgets/widgets/qplaintextedit.cpp b/src/widgets/widgets/qplaintextedit.cpp index dad0a6b7b6..baa207a18c 100644 --- a/src/widgets/widgets/qplaintextedit.cpp +++ b/src/widgets/widgets/qplaintextedit.cpp @@ -1383,7 +1383,7 @@ void QPlainTextEdit::redo() If there is no selected text nothing happens. - \sa copy() paste() + \sa copy(), paste() */ void QPlainTextEdit::cut() @@ -1415,7 +1415,7 @@ void QPlainTextEdit::copy() virtual canInsertFromMimeData() and insertFromMimeData() functions. - \sa cut() copy() + \sa cut(), copy() */ void QPlainTextEdit::paste() @@ -1430,7 +1430,7 @@ void QPlainTextEdit::paste() Note that the undo/redo history is cleared by this function. - \sa cut() setPlainText() + \sa cut(), setPlainText() */ void QPlainTextEdit::clear() { @@ -1444,7 +1444,7 @@ void QPlainTextEdit::clear() /*! Selects all text. - \sa copy() cut() textCursor() + \sa copy(), cut(), textCursor() */ void QPlainTextEdit::selectAll() { diff --git a/src/widgets/widgets/qprogressbar.cpp b/src/widgets/widgets/qprogressbar.cpp index 33c61796ea..b10f2882f7 100644 --- a/src/widgets/widgets/qprogressbar.cpp +++ b/src/widgets/widgets/qprogressbar.cpp @@ -338,7 +338,7 @@ int QProgressBar::value() const If the current value falls outside the new range, the progress bar is reset with reset(). - \sa minimum maximum + \sa minimum, maximum */ void QProgressBar::setRange(int minimum, int maximum) { diff --git a/src/widgets/widgets/qsizegrip.cpp b/src/widgets/widgets/qsizegrip.cpp index 4a5269c110..c9860f20ff 100644 --- a/src/widgets/widgets/qsizegrip.cpp +++ b/src/widgets/widgets/qsizegrip.cpp @@ -207,7 +207,7 @@ Qt::Corner QSizeGripPrivate::corner() const {QWidget::paintEvent()}{paintEvent()} function to render the size grip widget. - \sa QStatusBar QWidget::windowState() + \sa QStatusBar, QWidget::windowState() */ diff --git a/src/widgets/widgets/qspinbox.cpp b/src/widgets/widgets/qspinbox.cpp index cb88ca1b79..2911ef3766 100644 --- a/src/widgets/widgets/qspinbox.cpp +++ b/src/widgets/widgets/qspinbox.cpp @@ -356,7 +356,7 @@ void QSpinBox::setSingleStep(int value) The default minimum value is 0. - \sa setRange() specialValueText + \sa setRange(), specialValueText */ int QSpinBox::minimum() const @@ -383,7 +383,7 @@ void QSpinBox::setMinimum(int minimum) The default maximum value is 99. - \sa setRange() specialValueText + \sa setRange(), specialValueText */ @@ -409,7 +409,7 @@ void QSpinBox::setMaximum(int maximum) is equivalent to: \snippet code/src_gui_widgets_qspinbox.cpp 3 - \sa minimum maximum + \sa minimum, maximum */ void QSpinBox::setRange(int minimum, int maximum) @@ -728,7 +728,7 @@ void QDoubleSpinBox::setSingleStep(double value) Note: The minimum value will be rounded to match the decimals property. - \sa decimals, setRange() specialValueText + \sa decimals, setRange(), specialValueText */ double QDoubleSpinBox::minimum() const @@ -788,7 +788,7 @@ void QDoubleSpinBox::setMaximum(double maximum) is equivalent to: \snippet code/src_gui_widgets_qspinbox.cpp 7 - \sa minimum maximum + \sa minimum, maximum */ void QDoubleSpinBox::setRange(double minimum, double maximum) diff --git a/src/widgets/widgets/qsplitter.cpp b/src/widgets/widgets/qsplitter.cpp index 126f819541..8f1d52e9ad 100644 --- a/src/widgets/widgets/qsplitter.cpp +++ b/src/widgets/widgets/qsplitter.cpp @@ -182,7 +182,7 @@ QSplitter *QSplitterHandle::splitter() const right-to-left languages. This function will map \a pos to the appropriate position before calling QSplitter::moveSplitter(). - \sa QSplitter::moveSplitter() closestLegalPosition() + \sa QSplitter::moveSplitter(), closestLegalPosition() */ void QSplitterHandle::moveSplitter(int pos) { @@ -1086,7 +1086,7 @@ void QSplitter::resizeEvent(QResizeEvent *) If \a widget is already in the splitter, it will be moved to the new position. - \sa insertWidget() widget() indexOf() + \sa insertWidget(), widget(), indexOf() */ void QSplitter::addWidget(QWidget *widget) { @@ -1102,7 +1102,7 @@ void QSplitter::addWidget(QWidget *widget) if \a index is an invalid index, then the widget will be inserted at the end. - \sa addWidget() indexOf() widget() + \sa addWidget(), indexOf(), widget() */ void QSplitter::insertWidget(int index, QWidget *widget) { @@ -1201,7 +1201,7 @@ int QSplitter::count() const putting widgets into a splitter in new code. Please use insertWidget() or addWidget() in new code. - \sa addWidget() insertWidget() + \sa addWidget(), insertWidget() */ void QSplitter::childEvent(QChildEvent *c) diff --git a/src/widgets/widgets/qtabbar.cpp b/src/widgets/widgets/qtabbar.cpp index 7b5b3b6559..2e46ec627b 100644 --- a/src/widgets/widgets/qtabbar.cpp +++ b/src/widgets/widgets/qtabbar.cpp @@ -119,7 +119,7 @@ void QTabBarPrivate::updateMacBorderMetrics() This function will check the version of the QStyleOptionTab and fill in the additional values for a QStyleOptionTabV2 and QStyleOptionTabV3. - \sa QStyleOption::initFrom() QTabWidget::initStyleOption() + \sa QStyleOption::initFrom(), QTabWidget::initStyleOption() */ void QTabBar::initStyleOption(QStyleOptionTab *option, int tabIndex) const { @@ -739,7 +739,7 @@ void QTabBar::setShape(Shape shape) If true then QTabBar draws a base in relation to the styles overlab. Otherwise only the tabs are drawn. - \sa QStyle::pixelMetric() QStyle::PM_TabBarBaseOverlap QStyleOptionTabBarBaseV2 + \sa QStyle::pixelMetric(), QStyle::PM_TabBarBaseOverlap, QStyleOptionTabBarBaseV2 */ void QTabBar::setDrawBase(bool drawBase) @@ -1992,7 +1992,7 @@ void QTabBar::changeEvent(QEvent *event) By default the value is style dependent. - \sa QTabWidget::elideMode usesScrollButtons QStyle::SH_TabBar_ElideMode + \sa QTabWidget::elideMode, usesScrollButtons, QStyle::SH_TabBar_ElideMode */ Qt::TextElideMode QTabBar::elideMode() const @@ -2020,7 +2020,7 @@ void QTabBar::setElideMode(Qt::TextElideMode mode) By default the value is style dependant. - \sa elideMode QTabWidget::usesScrollButtons QStyle::SH_TabBar_PreferNoArrows + \sa elideMode, QTabWidget::usesScrollButtons, QStyle::SH_TabBar_PreferNoArrows */ bool QTabBar::usesScrollButtons() const { diff --git a/src/widgets/widgets/qtabwidget.cpp b/src/widgets/widgets/qtabwidget.cpp index 505287512e..317b8e1b2a 100644 --- a/src/widgets/widgets/qtabwidget.cpp +++ b/src/widgets/widgets/qtabwidget.cpp @@ -161,7 +161,7 @@ QT_BEGIN_NAMESPACE if there isn't a new one (for example, if there are no widgets in the QTabWidget) - \sa currentWidget() currentIndex + \sa currentWidget(), currentIndex */ /*! @@ -256,7 +256,7 @@ bool QTabWidget::hasHeightForWidth() const for subclasses when they need a QStyleOptionTabWidgetFrame, but don't want to fill in all the information themselves. - \sa QStyleOption::initFrom() QTabBar::initStyleOption() + \sa QStyleOption::initFrom(), QTabBar::initStyleOption() */ void QTabWidget::initStyleOption(QStyleOptionTabWidgetFrame *option) const { @@ -1133,7 +1133,7 @@ int QTabWidget::count() const /*! Sets the tab tool tip for the page at position \a index to \a tip. - \sa tabToolTip() + \sa tabToolTip() */ void QTabWidget::setTabToolTip(int index, const QString & tip) { @@ -1267,7 +1267,7 @@ void QTabWidget::setIconSize(const QSize &size) By default the value is style dependant. - \sa QTabBar::elideMode usesScrollButtons QStyle::SH_TabBar_ElideMode + \sa QTabBar::elideMode, usesScrollButtons, QStyle::SH_TabBar_ElideMode */ Qt::TextElideMode QTabWidget::elideMode() const { @@ -1290,7 +1290,7 @@ void QTabWidget::setElideMode(Qt::TextElideMode mode) By default the value is style dependant. - \sa elideMode QTabBar::usesScrollButtons QStyle::SH_TabBar_PreferNoArrows + \sa elideMode, QTabBar::usesScrollButtons, QStyle::SH_TabBar_PreferNoArrows */ bool QTabWidget::usesScrollButtons() const { diff --git a/src/widgets/widgets/qtextedit.cpp b/src/widgets/widgets/qtextedit.cpp index 7a7b977b89..3dbd24705b 100644 --- a/src/widgets/widgets/qtextedit.cpp +++ b/src/widgets/widgets/qtextedit.cpp @@ -613,7 +613,7 @@ QTextEdit::~QTextEdit() /*! Returns the point size of the font of the current format. - \sa setFontFamily() setCurrentFont() setFontPointSize() + \sa setFontFamily(), setCurrentFont(), setFontPointSize() */ qreal QTextEdit::fontPointSize() const { @@ -624,7 +624,7 @@ qreal QTextEdit::fontPointSize() const /*! Returns the font family of the current format. - \sa setFontFamily() setCurrentFont() setFontPointSize() + \sa setFontFamily(), setCurrentFont(), setFontPointSize() */ QString QTextEdit::fontFamily() const { @@ -635,7 +635,7 @@ QString QTextEdit::fontFamily() const /*! Returns the font weight of the current format. - \sa setFontWeight() setCurrentFont() setFontPointSize() QFont::Weight + \sa setFontWeight(), setCurrentFont(), setFontPointSize(), QFont::Weight */ int QTextEdit::fontWeight() const { @@ -694,7 +694,7 @@ QColor QTextEdit::textBackgroundColor() const /*! Returns the font of the current format. - \sa setCurrentFont() setFontFamily() setFontPointSize() + \sa setCurrentFont(), setFontFamily(), setFontPointSize() */ QFont QTextEdit::currentFont() const { @@ -782,7 +782,7 @@ QTextCursor QTextEdit::textCursor() const /*! Sets the font family of the current format to \a fontFamily. - \sa fontFamily() setCurrentFont() + \sa fontFamily(), setCurrentFont() */ void QTextEdit::setFontFamily(const QString &fontFamily) { @@ -797,7 +797,7 @@ void QTextEdit::setFontFamily(const QString &fontFamily) Note that if \a s is zero or negative, the behavior of this function is not defined. - \sa fontPointSize() setCurrentFont() setFontFamily() + \sa fontPointSize(), setCurrentFont(), setFontFamily() */ void QTextEdit::setFontPointSize(qreal s) { @@ -877,7 +877,7 @@ void QTextEdit::setTextBackgroundColor(const QColor &c) /*! Sets the font of the current format to \a f. - \sa currentFont() setFontPointSize() setFontFamily() + \sa currentFont(), setFontPointSize(), setFontFamily() */ void QTextEdit::setCurrentFont(const QFont &f) { @@ -935,7 +935,7 @@ void QTextEdit::redo() If there is no selected text nothing happens. - \sa copy() paste() + \sa copy(), paste() */ void QTextEdit::cut() @@ -967,7 +967,7 @@ void QTextEdit::copy() virtual canInsertFromMimeData() and insertFromMimeData() functions. - \sa cut() copy() + \sa cut(), copy() */ void QTextEdit::paste() @@ -982,7 +982,7 @@ void QTextEdit::paste() Note that the undo/redo history is cleared by this function. - \sa cut() setPlainText() setHtml() + \sa cut(), setPlainText(), setHtml() */ void QTextEdit::clear() { @@ -995,7 +995,7 @@ void QTextEdit::clear() /*! Selects all text. - \sa copy() cut() textCursor() + \sa copy(), cut(), textCursor() */ void QTextEdit::selectAll() { diff --git a/src/widgets/widgets/qtoolbar.cpp b/src/widgets/widgets/qtoolbar.cpp index 6ba29c13b8..ddc6686265 100644 --- a/src/widgets/widgets/qtoolbar.cpp +++ b/src/widgets/widgets/qtoolbar.cpp @@ -484,7 +484,7 @@ void QToolBarPrivate::plug(const QRect &r) This signal is emitted when the icon size is changed. The \a iconSize parameter holds the toolbar's new icon size. - \sa iconSize QMainWindow::iconSize + \sa iconSize, QMainWindow::iconSize */ /*! @@ -513,7 +513,7 @@ void QToolBarPrivate::plug(const QRect &r) \a toolButtonStyle parameter holds the toolbar's new tool button style. - \sa toolButtonStyle QMainWindow::toolButtonStyle + \sa toolButtonStyle, QMainWindow::toolButtonStyle */ /*! @@ -1209,7 +1209,7 @@ bool QToolBar::event(QEvent *event) The action's text is set to the toolbar's window title. - \sa QAction::text QWidget::windowTitle + \sa QAction::text, QWidget::windowTitle */ QAction *QToolBar::toggleViewAction() const { Q_D(const QToolBar); return d->toggleViewAction; } -- cgit v1.2.3