diff --git a/src/kcapacitybar.h b/src/kcapacitybar.h --- a/src/kcapacitybar.h +++ b/src/kcapacitybar.h @@ -200,7 +200,7 @@ /** * Set the way text is drawn if any is set * - * @param drawTextMode If any text set, whether to draw it into the capacity bar + * @param mode If any text set, whether to draw it into the capacity bar * or not. */ void setDrawTextMode(DrawTextMode mode); diff --git a/src/kcolorcombo.h b/src/kcolorcombo.h --- a/src/kcolorcombo.h +++ b/src/kcolorcombo.h @@ -75,7 +75,7 @@ /** * Set a custom list of colors to choose from, in place of the standard * list. - * @param cols list of colors. If empty, the selection list reverts to + * @param colors list of colors. If empty, the selection list reverts to * the standard list. **/ void setColors(const QList &colors); diff --git a/src/kdatecombobox.h b/src/kdatecombobox.h --- a/src/kdatecombobox.h +++ b/src/kdatecombobox.h @@ -227,7 +227,7 @@ * @param minDate the minimum date * @param minWarnMsg the minimum warning message */ - void setMinimumDate(const QDate &minTime, const QString &minWarnMsg = QString()); + void setMinimumDate(const QDate &minDate, const QString &minWarnMsg = QString()); /** * Reset the minimum date to the default. diff --git a/src/kdatetimeedit.h b/src/kdatetimeedit.h --- a/src/kdatetimeedit.h +++ b/src/kdatetimeedit.h @@ -114,9 +114,9 @@ QTimeZone timeZone() const; /** - * Returns the list of Calendar Systems displayed. + * Returns the list of Calendar Locales displayed. * - * @param calendars the list of calendar systems to display + * @return the list of calendar locales displayed */ QList calendarLocalesList() const; @@ -181,7 +181,7 @@ /** * Return the list of time zones able to be selected * - * @param zones the time zones to display + * @return the list of time zones displayed */ QList timeZones() const; @@ -342,15 +342,15 @@ /** * Signal if the time zone has been changed manually by the user. * - * @param timeZone the new time zone + * @param zone the new time zone */ void timeZoneEntered(const QTimeZone &zone); /** * Signal if the time zone has been changed either manually by the user * or programatically. * - * @param timeZone the new time zone + * @param zone the new time zone */ void timeZoneChanged(const QTimeZone &zone); @@ -421,8 +421,8 @@ * * @see setMaximumDateTime() * @see setDateRange() - * @param maxDate the minimum date - * @param maxWarnMsg the minimum warning message + * @param minDateTime the minimum date + * @param minWarnMsg the minimum warning message */ void setMinimumDateTime(const QDateTime &minDateTime, const QString &minWarnMsg = QString()); @@ -439,7 +439,7 @@ * * @see setMinimumDateTime() * @see setDateRange() - * @param maxDate the maximum date + * @param maxDateTime the maximum date * @param maxWarnMsg the maximum warning message */ void setMaximumDateTime(const QDateTime &maxDateTime, const QString &maxWarnMsg = QString()); @@ -489,12 +489,12 @@ * * @param format the time format to use */ - void setTimeDisplayFormat(QLocale::FormatType formatOptions); + void setTimeDisplayFormat(QLocale::FormatType format); /** * Set the interval between times able to be selected from the drop-down. * - * The combo drop-down will be populated with times every @param minutes + * The combo drop-down will be populated with times every @p minutes * apart, starting from the minimumTime() and ending at maximumTime(). * * If the ForceInterval option is set then any time manually typed into the @@ -553,7 +553,7 @@ * Virtual to allow sub-classes to apply extra validation rules, * but reimplementations must call the parent method at the end. * - * @param datetime the new date and time + * @param dateTime the new date and time */ virtual void assignDateTime(const QDateTime &dateTime); diff --git a/src/kled.h b/src/kled.h --- a/src/kled.h +++ b/src/kled.h @@ -208,7 +208,7 @@ /** * Sets the factor to darken the LED in KLed::Off state. * - * The @param darkFactor should be greater than 100, otherwise the LED + * The @p darkFactor should be greater than 100, otherwise the LED * becomes lighter in KLed::Off state. * * Defaults to 300. diff --git a/src/kmimetypeeditor.h b/src/kmimetypeeditor.h --- a/src/kmimetypeeditor.h +++ b/src/kmimetypeeditor.h @@ -34,7 +34,7 @@ /** * Starts the file types editor for a given MIME type. * @param mimeType the mimetype to edit, e.g. "text/plain" - * @param the parent widget + * @param widget the parent widget * @since 5.4 */ KWIDGETSADDONS_EXPORT void editMimeType(const QString &mimeType, QWidget *widget); diff --git a/src/kpagedialog.h b/src/kpagedialog.h --- a/src/kpagedialog.h +++ b/src/kpagedialog.h @@ -207,7 +207,8 @@ /** * This signal is emitted whenever the current page has changed. * - * @param item The new current page or 0 if no current page is available. + * @param current The new current page or 0 if no current page is available. + * @param before The page that was current before the new current page has changed. */ void currentPageChanged(KPageWidgetItem *current, KPageWidgetItem *before); diff --git a/src/kpagewidget.h b/src/kpagewidget.h --- a/src/kpagewidget.h +++ b/src/kpagewidget.h @@ -133,13 +133,14 @@ /** * This signal is emitted whenever the current page has changed. * - * @param item The new current page or 0 if no current page is available. + * @param current The new current page or 0 if no current page is available. + * @param before The page that was current before the new current page has changed. */ void currentPageChanged(KPageWidgetItem *current, KPageWidgetItem *before); /** * This signal is emitted whenever a checkable page changes its state. @param checked is true - * when the @param page is checked, or false if the @param page is unchecked. + * when the @p page is checked, or false if the @p page is unchecked. */ void pageToggled(KPageWidgetItem *page, bool checked); diff --git a/src/kpagewidgetmodel.h b/src/kpagewidgetmodel.h --- a/src/kpagewidgetmodel.h +++ b/src/kpagewidgetmodel.h @@ -294,7 +294,7 @@ Q_SIGNALS: /** * This signal is emitted whenever a checkable page changes its state. @param checked is true - * when the @param page is checked, or false if the @param page is unchecked. + * when the @p page is checked, or false if the @p page is unchecked. */ void toggled(KPageWidgetItem *page, bool checked); diff --git a/src/kpixmapsequence.h b/src/kpixmapsequence.h --- a/src/kpixmapsequence.h +++ b/src/kpixmapsequence.h @@ -67,7 +67,7 @@ /** * Create a sequence from an icon name. * - * \param iconName The full path of the icon + * \param fullPath The full path of the icon * \param size The icon/frame size */ KPixmapSequence(const QString &fullPath, int size); diff --git a/src/ksplittercollapserbutton.h b/src/ksplittercollapserbutton.h --- a/src/ksplittercollapserbutton.h +++ b/src/ksplittercollapserbutton.h @@ -43,7 +43,7 @@ /** * @brief KSplitterCollapserButton create a splitter collapser * @param childWidget the widget, child of the splitter, whose size is controlled by this collapser - * @param the splitter which this collapser should be associated with. + * @param splitter the splitter which this collapser should be associated with. */ explicit KSplitterCollapserButton(QWidget *childWidget, QSplitter *splitter); @@ -71,7 +71,7 @@ void restore(); /** * @brief setCollapsed, this function allows to collapse or not the splitter. - * @param collapsed + * @param collapsed if the splitter should be collapsed */ void setCollapsed(bool collapsed); diff --git a/src/ksqueezedtextlabel.h b/src/ksqueezedtextlabel.h --- a/src/ksqueezedtextlabel.h +++ b/src/ksqueezedtextlabel.h @@ -98,7 +98,7 @@ * squeezed->setText("new text"); // works as expected * static_cast(label)->setText("new text"); // works as expected * \endcode - * @param mode The new text. + * @param text The new text. */ void setText(const QString &text); /** diff --git a/src/kstandardguiitem.h b/src/kstandardguiitem.h --- a/src/kstandardguiitem.h +++ b/src/kstandardguiitem.h @@ -53,14 +53,14 @@ }; /** - * Returns the gui item for the given identifier @param id. + * Returns the gui item for the given identifier @p id. * * @param id the identifier to search for */ KWIDGETSADDONS_EXPORT KGuiItem guiItem(StandardItem id); /** - * Returns the name of the gui item for the given identifier @param id. + * Returns the name of the gui item for the given identifier @p id. * * @param id the identifier to search for */ diff --git a/src/ktimecombobox.h b/src/ktimecombobox.h --- a/src/ktimecombobox.h +++ b/src/ktimecombobox.h @@ -227,7 +227,7 @@ * * @param format the time format to use */ - void setDisplayFormat(QLocale::FormatType formatOptions); + void setDisplayFormat(QLocale::FormatType format); /** * Set the minimum allowed time. @@ -262,7 +262,7 @@ /** * Set the interval between times able to be selected from the drop-down. * - * The combo drop-down will be populated with times every @param minutes + * The combo drop-down will be populated with times every @p minutes * apart, starting from the minimumTime() and ending at maximumTime(). * * If the ForceInterval option is set then any time manually typed into the diff --git a/src/ktitlewidget.h b/src/ktitlewidget.h --- a/src/ktitlewidget.h +++ b/src/ktitlewidget.h @@ -95,7 +95,7 @@ }; /** - * Constructs a title widget with the given @param parent. + * Constructs a title widget. */ explicit KTitleWidget(QWidget *parent = nullptr); @@ -178,14 +178,14 @@ void setPixmap(const QString &icon, ImageAlignment alignment = ImageRight); /** - * @param pixmap the icon to display in the header. The pixmap is by default right, but + * @param icon the icon to display in the header. The pixmap is by default right, but * @param alignment can be used to display it also left. * @see pixmap() */ void setPixmap(const QIcon &icon, ImageAlignment alignment = ImageRight); /** - * @param pixmap the icon to display in the header. The pixmap is by default right, but + * @param type the type of message icon to display in the header. The pixmap is by default right, but * @param alignment can be used to display it also left. * @see pixmap() */