diff --git a/umbrello/codeimport/pythonimport.cpp b/umbrello/codeimport/pythonimport.cpp --- a/umbrello/codeimport/pythonimport.cpp +++ b/umbrello/codeimport/pythonimport.cpp @@ -208,7 +208,7 @@ } /** - * Parse assignments in the form '=' + * Parse assignments in the form \ '=' \ * Instance variables are identified by a prefixed 'self.'. * @return success status of parsing */ diff --git a/umbrello/codeimport/sqlimport.cpp b/umbrello/codeimport/sqlimport.cpp --- a/umbrello/codeimport/sqlimport.cpp +++ b/umbrello/codeimport/sqlimport.cpp @@ -242,7 +242,7 @@ * Parse default expression. * * The expression could be in the form - * (expression):: + * (expression)\::\ * function(expression) * * @param token string with current token diff --git a/umbrello/codeimpwizard/codeimpthread.cpp b/umbrello/codeimpwizard/codeimpthread.cpp --- a/umbrello/codeimpwizard/codeimpthread.cpp +++ b/umbrello/codeimpwizard/codeimpthread.cpp @@ -83,7 +83,7 @@ /** * Emit a signal to the main gui thread to show a question box. * @param question the text of the question - * @return the code of the answer button @ref KMessageBox::ButtonCode + * @return the code of the answer button KMessageBox::ButtonCode */ int CodeImpThread::emitAskQuestion(const QString& question) { diff --git a/umbrello/diagram_utils.cpp b/umbrello/diagram_utils.cpp --- a/umbrello/diagram_utils.cpp +++ b/umbrello/diagram_utils.cpp @@ -137,11 +137,13 @@ /** * Qtcreator/gdb + * @verbatim * 6 Driver::ParseHelper::ParseHelper driver.cpp 299 0x634c44 * 31 g_main_context_dispatch /usr/lib64/libglib-2.0.so.0 0x7fffefe16316 * ignoring * ... 0x7ffff41152d9 * 13 ?? 0x7ffff41152d9 + * @endverbatim */ else if (cols[cols.size()-1].startsWith(QLatin1String("0x"))) { if (cols[0] == QLatin1String("...") || cols[1] == QLatin1String("??")) diff --git a/umbrello/dialogs/dontaskagain.h b/umbrello/dialogs/dontaskagain.h --- a/umbrello/dialogs/dontaskagain.h +++ b/umbrello/dialogs/dontaskagain.h @@ -89,7 +89,7 @@ * support in an application setting dialog. * * To use this support call macro @ref DefineDontAskAgainItem and add a call to method - * @ref DontAskAgainItem::name as parameter @ref dontAskAgainName to related class KMessageBox + * DontAskAgainItem::name as parameter @ref dontAskAgainName to related class KMessageBox * methods. See the following example: * * \code{.cpp} diff --git a/umbrello/dialogs/messagewidgetpropertiesdialog.cpp b/umbrello/dialogs/messagewidgetpropertiesdialog.cpp --- a/umbrello/dialogs/messagewidgetpropertiesdialog.cpp +++ b/umbrello/dialogs/messagewidgetpropertiesdialog.cpp @@ -19,7 +19,6 @@ * Sets up an Message Widget Properties Dialog. * @param parent The parent of the dialog * @param widget The Message Widget to display properties of. - * @param pageNum The page to show first. */ MessageWidgetPropertiesDialog::MessageWidgetPropertiesDialog (QWidget *parent, MessageWidget * widget) : MultiPageDialogBase(parent), diff --git a/umbrello/dialogs/multipagedialogbase.cpp b/umbrello/dialogs/multipagedialogbase.cpp --- a/umbrello/dialogs/multipagedialogbase.cpp +++ b/umbrello/dialogs/multipagedialogbase.cpp @@ -458,7 +458,7 @@ /** * updates the font page data - * @param widget Widget to save the font data into + * @param scene Scene to save the font data into */ void MultiPageDialogBase::applyFontPage(UMLScene *scene) { diff --git a/umbrello/dialogs/pages/associationgeneralpage.cpp b/umbrello/dialogs/pages/associationgeneralpage.cpp --- a/umbrello/dialogs/pages/associationgeneralpage.cpp +++ b/umbrello/dialogs/pages/associationgeneralpage.cpp @@ -41,7 +41,6 @@ /** * Sets up the AssociationGeneralPage. * - * @param d The UMLDoc which controls controls object creation. * @param parent The parent to the AssociationGeneralPage. * @param assoc The AssociationWidget to display the properties of. */ diff --git a/umbrello/dialogs/pages/associationrolepage.cpp b/umbrello/dialogs/pages/associationrolepage.cpp --- a/umbrello/dialogs/pages/associationrolepage.cpp +++ b/umbrello/dialogs/pages/associationrolepage.cpp @@ -36,7 +36,6 @@ /** * Sets up the AssociationRolePage. - * @param d The UMLDoc which controls controls object creation. * @param parent The parent to the AssociationRolePage. * @param assoc The AssociationWidget to display the properties of. */ diff --git a/umbrello/dialogs/pages/uioptionspage.cpp b/umbrello/dialogs/pages/uioptionspage.cpp --- a/umbrello/dialogs/pages/uioptionspage.cpp +++ b/umbrello/dialogs/pages/uioptionspage.cpp @@ -38,7 +38,6 @@ * * @param pParent Parent widget * @param options Settings to read from/save into - * @param isDiagram Flag if object is for display diagram class options */ UIOptionsPage::UIOptionsPage(QWidget* pParent, Settings::OptionState *options) : DialogPageBase(pParent), diff --git a/umbrello/dialogs/widgets/defaultvaluewidget.cpp b/umbrello/dialogs/widgets/defaultvaluewidget.cpp --- a/umbrello/dialogs/widgets/defaultvaluewidget.cpp +++ b/umbrello/dialogs/widgets/defaultvaluewidget.cpp @@ -135,7 +135,7 @@ * name. If an object was found, the display of the selectable * options depends on the type. * - * @param type type as text to set the widget from + * @param _type type as text to set the widget from */ void DefaultValueWidget::setType(const QString &_type) { diff --git a/umbrello/menus/associationwidgetpopupmenu.cpp b/umbrello/menus/associationwidgetpopupmenu.cpp --- a/umbrello/menus/associationwidgetpopupmenu.cpp +++ b/umbrello/menus/associationwidgetpopupmenu.cpp @@ -24,9 +24,8 @@ * Constructs the popup menu for a scene widget. * * @param parent The parent to ListPopupMenu. - * @param object The WidgetBase to represent a menu for. - * @param multi True if multiple items are selected. - * @param uniqueType The type of widget shared by all selected widgets + * @param type The type of widget shared by all selected widgets. + * @param widget The AssociationWidget to represent a menu for. */ AssociationWidgetPopupMenu::AssociationWidgetPopupMenu(QWidget *parent, Uml::AssociationType::Enum type, AssociationWidget *widget) : ListPopupMenu(parent) diff --git a/umbrello/menus/listpopupmenu.cpp b/umbrello/menus/listpopupmenu.cpp --- a/umbrello/menus/listpopupmenu.cpp +++ b/umbrello/menus/listpopupmenu.cpp @@ -661,7 +661,7 @@ /** * dump collected actions - * @param type optional menu type + * @param title optional menu title */ void ListPopupMenu::dumpActions(const QString &title) { diff --git a/umbrello/menus/widgetbasepopupmenu.cpp b/umbrello/menus/widgetbasepopupmenu.cpp --- a/umbrello/menus/widgetbasepopupmenu.cpp +++ b/umbrello/menus/widgetbasepopupmenu.cpp @@ -37,7 +37,7 @@ * Constructs the popup menu for a scene widget. * * @param parent The parent to ListPopupMenu. - * @param object The WidgetBase to represent a menu for. + * @param widget The WidgetBase to represent a menu for. * @param multi True if multiple items are selected. * @param uniqueType The type of widget shared by all selected widgets */ diff --git a/umbrello/model_utils.cpp b/umbrello/model_utils.cpp --- a/umbrello/model_utils.cpp +++ b/umbrello/model_utils.cpp @@ -1839,7 +1839,7 @@ /** * Converts a list view type enum to the equivalent settings dialog type. * - * @param lvt The ListViewType to convert. + * @param type The ListViewType to convert. * @return The converted settings dialog type */ MultiPageDialogBase::PageType convert_LVT_PT(UMLListViewItem::ListViewType type) diff --git a/umbrello/refactoring/refactoringassistant.cpp b/umbrello/refactoring/refactoringassistant.cpp --- a/umbrello/refactoring/refactoringassistant.cpp +++ b/umbrello/refactoring/refactoringassistant.cpp @@ -192,8 +192,6 @@ /** * Slot for updating the tree item properties according to the given UML object. - * If no parameter is given the sender is used. - * @param obj the UML object */ void RefactoringAssistant::objectModified() { diff --git a/umbrello/uml1model/datatype.cpp b/umbrello/uml1model/datatype.cpp --- a/umbrello/uml1model/datatype.cpp +++ b/umbrello/uml1model/datatype.cpp @@ -69,7 +69,7 @@ /** * Loads object from QDomElement. * - * @param qElement A QDomElement which contains xml info for this object. + * @param element A QDomElement which contains xml info for this object. */ bool UMLDatatype::loadFromXMI1(QDomElement & element) { diff --git a/umbrello/uml1model/umlobject.cpp b/umbrello/uml1model/umlobject.cpp --- a/umbrello/uml1model/umlobject.cpp +++ b/umbrello/uml1model/umlobject.cpp @@ -652,7 +652,7 @@ * * @param parent object to set as parent * - * @TODO prevent setting parent to myself + * TODO prevent setting parent to myself */ void UMLObject::setUMLParent(UMLObject *parent) { @@ -1128,7 +1128,7 @@ /** * Returns the given object type value as localized string. - * @param ot ObjectType of which a string representation is wanted + * @param t ObjectType of which a string representation is wanted * @return the ObjectType as localized string */ QString UMLObject::toI18nString(ObjectType t) diff --git a/umbrello/umldoc.cpp b/umbrello/umldoc.cpp --- a/umbrello/umldoc.cpp +++ b/umbrello/umldoc.cpp @@ -1962,7 +1962,7 @@ /** * Set coordinates resolution for current document. - * @param document resolution in DPI + * @param resolution document resolution in DPI */ void UMLDoc::setResolution(qreal resolution) { @@ -2512,7 +2512,7 @@ /** * Add a xml node containing a diagram to the list of diagrams to load. - * Helper function for @ref loadDiagrams(). + * Helper function for loadDiagrams(). * * @param folder pointer to UMFolder instance the diagrams belongs to * @param node xml document node containing the diagram diff --git a/umbrello/umlwidgets/associationwidget.cpp b/umbrello/umlwidgets/associationwidget.cpp --- a/umbrello/umlwidgets/associationwidget.cpp +++ b/umbrello/umlwidgets/associationwidget.cpp @@ -465,8 +465,6 @@ /** * Overrides operation from LinkWidget. * Required by FloatingTextWidget. - * - * @param op Return this AssociationWidget's operation string. */ QString AssociationWidget::lwOperationText() { diff --git a/umbrello/umlwidgets/classifierwidget.cpp b/umbrello/umlwidgets/classifierwidget.cpp --- a/umbrello/umlwidgets/classifierwidget.cpp +++ b/umbrello/umlwidgets/classifierwidget.cpp @@ -91,7 +91,7 @@ * Constructs a ClassifierWidget. * * @param scene The parent of this ClassifierWidget. - * @param c The UMLClassifier to represent. + * @param o The UMLPackage to represent. */ ClassifierWidget::ClassifierWidget(UMLScene * scene, UMLPackage *o) : UMLWidget(scene, WidgetBase::wt_Package, o), @@ -703,7 +703,7 @@ /** * Overrides standard method. * Auxiliary to reimplementations in the derived classes. - * @NOTE keep fetching attributes in sync with calculateSize() + * @note keep fetching attributes in sync with calculateSize() */ void ClassifierWidget::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) { diff --git a/umbrello/umlwidgets/umlwidget.cpp b/umbrello/umlwidgets/umlwidget.cpp --- a/umbrello/umlwidgets/umlwidget.cpp +++ b/umbrello/umlwidgets/umlwidget.cpp @@ -2003,7 +2003,7 @@ /** * Adds a widget to the diagram, which is connected to the current widget * @param widget widget instance to add to diagram - * @param type association type + * @param showProperties whether to show properties of the widget */ void UMLWidget::addWidget(UMLWidget *widget, bool showProperties) {