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 <giuseppe.dangelo@kdab.com>
Reviewed-by: Casper van Donderen <casper.vandonderen@nokia.com>

20 files changed, 80 insertions, 80 deletions

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; }