alecs/plasma-framework
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Replace doxygen tag @arg by @param.

Browse Source 
The @param doxygen tag is formatted way nicer and should be used
throughout our apidox.

REVIEW: 101596
This commit is contained in:
Frederik Schwarzer 2011-06-13 14:47:29 +02:00
parent d905597069
commit 5c0d0e8e8e
56 changed files with 317 additions and 317 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
abstractrunner.h
View File

@ -141,7 +141,7 @@ class PLASMA_EXPORT AbstractRunner : public QObject
/** /**
* Triggers a call to match. This will call match() internally. * Triggers a call to match. This will call match() internally.
* *
* @arg context the search context used in executing this match. * @param context the search context used in executing this match.
*/ */
void performMatch(Plasma::RunnerContext &context); void performMatch(Plasma::RunnerContext &context);
@ -337,8 +337,8 @@ class PLASMA_EXPORT AbstractRunner : public QObject
* a measure of safety for runners running their own threads. This should * a measure of safety for runners running their own threads. This should
* be used instead of calling KServiceTypeTrader::query(..) directly. * be used instead of calling KServiceTypeTrader::query(..) directly.
* *
* @arg serviceType a service type like "Plasma/Applet" or "KFilePlugin" * @param serviceType a service type like "Plasma/Applet" or "KFilePlugin"
* @arg constraint a constraint to limit the choices returned. * @param constraint a constraint to limit the choices returned.
* @see KServiceTypeTrader::query(const QString&, const QString&) * @see KServiceTypeTrader::query(const QString&, const QString&)
* *
* @return a list of services that satisfy the query. * @return a list of services that satisfy the query.

4
animations/animation.h
View File

@ -102,7 +102,7 @@ public:
/** /**
* Set the widget on which the animation is to be performed. * Set the widget on which the animation is to be performed.
* @arg widget The QGraphicsWidget to be animated. * @param widget The QGraphicsWidget to be animated.
*/ */
void setTargetWidget(QGraphicsWidget* widget); void setTargetWidget(QGraphicsWidget* widget);
@ -124,7 +124,7 @@ public:
protected: protected:
/** /**
* Change the animation duration. Default is 250ms. * Change the animation duration. Default is 250ms.
* @arg duration The new duration of the animation. * @param duration The new duration of the animation.
*/ */
virtual void setDuration(int duration = 250); virtual void setDuration(int duration = 250);

2
animations/geometry_p.h
View File

@ -62,7 +62,7 @@ public:
* *
* If no geometry is set, it will use the widget current geometry * If no geometry is set, it will use the widget current geometry
* when the animation is first run). * when the animation is first run).
* @arg geometry The initial geometry. * @param geometry The initial geometry.
*/ */
void setStartGeometry(const QRectF &geometry); void setStartGeometry(const QRectF &geometry);

8
animations/rotation_p.h
View File

@ -80,27 +80,27 @@ public:
/** /**
* Reimplemented from Plasma::Animation * Reimplemented from Plasma::Animation
* @arg curve Easing curve * @param curve Easing curve
*/ */
void setEasingCurve(const QEasingCurve &curve); void setEasingCurve(const QEasingCurve &curve);
public slots: public slots:
/** /**
* set animation rotation axis * set animation rotation axis
* @arg axis Rotation (e.g. YAxis, ZAxis, XAxis) * @param axis Rotation (e.g. YAxis, ZAxis, XAxis)
*/ */
void setAxis(const Qt::Axis &axis); void setAxis(const Qt::Axis &axis);
/** /**
* Set rotation reference (e.g. Center, Up, Down, Left, Right) can * Set rotation reference (e.g. Center, Up, Down, Left, Right) can
* be combined (i.e. Center|Up) * be combined (i.e. Center|Up)
* @arg reference The reference * @param reference The reference
*/ */
void setReference(const qint8 &reference); void setReference(const qint8 &reference);
/** /**
* Set animation rotation angle (e.g. 45, 180, etc) * Set animation rotation angle (e.g. 45, 180, etc)
* @arg angle The angle * @param angle The angle
*/ */
void setAngle(const qreal &angle); void setAngle(const qreal &angle);

6
animations/rotationstacked_p.h
View File

@ -57,7 +57,7 @@ public:
/** /**
* Set the animation movement direction (e.g. MoveAny, MoveUp, MoveDown, * Set the animation movement direction (e.g. MoveAny, MoveUp, MoveDown,
* MoveLeft, MoveRight) which can be combined (i.e. MoveUp|MoveLeft). * MoveLeft, MoveRight) which can be combined (i.e. MoveUp|MoveLeft).
* @arg direction animation direction * @param direction animation direction
*/ */
void setMovementDirection(const Animation::MovementDirection &direction); void setMovementDirection(const Animation::MovementDirection &direction);
@ -69,7 +69,7 @@ public:
/** /**
* Set the animation rotation reference (e.g. Center, Up, Down, Left, * Set the animation rotation reference (e.g. Center, Up, Down, Left,
* Right) which can be combined (i.e. Center|Up). * Right) which can be combined (i.e. Center|Up).
* @arg reference animation reference * @param reference animation reference
*/ */
void setReference(const Animation::Reference &reference); void setReference(const Animation::Reference &reference);
@ -91,7 +91,7 @@ public:
/** /**
* Set the back widget that is used after the animation to be finished * Set the back widget that is used after the animation to be finished
* @arg backWidget The back widget * @param backWidget The back widget
*/ */
void setBackWidget(QGraphicsWidget *backWidget); void setBackWidget(QGraphicsWidget *backWidget);

2
animations/slide_p.h
View File

@ -66,7 +66,7 @@ public:
/** /**
* Set the animation direction * Set the animation direction
* @arg direction animation direction * @param direction animation direction
*/ */
void setMovementDirection(const Animation::MovementDirection&direction); void setMovementDirection(const Animation::MovementDirection&direction);

24
animator.h
View File

@ -115,8 +115,8 @@ public:
/** /**
* Starts a standard animation on a QGraphicsItem. * Starts a standard animation on a QGraphicsItem.
* *
* @arg item the item to animate in some fashion * @param item the item to animate in some fashion
* @arg anim the type of animation to perform * @param anim the type of animation to perform
* @return the id of the animation * @return the id of the animation
* @deprecated use new Animator API with Qt Kinetic * @deprecated use new Animator API with Qt Kinetic
**/ **/
@ -129,7 +129,7 @@ public:
* Note that it is not necessary to call * Note that it is not necessary to call
* this on normal completion of the animation. * this on normal completion of the animation.
* *
* @arg id the id of the animation as returned by animateItem * @param id the id of the animation as returned by animateItem
* @deprecated use new Animator API with Qt Kinetic * @deprecated use new Animator API with Qt Kinetic
*/ */
#ifndef KDE_NO_DEPRECATED #ifndef KDE_NO_DEPRECATED
@ -139,8 +139,8 @@ public:
/** /**
* Starts a standard animation on a QGraphicsItem. * Starts a standard animation on a QGraphicsItem.
* *
* @arg item the item to animate in some fashion * @param item the item to animate in some fashion
* @arg anim the type of animation to perform * @param anim the type of animation to perform
* @return the id of the animation * @return the id of the animation
* @deprecated use new Animator API with Qt Kinetic * @deprecated use new Animator API with Qt Kinetic
**/ **/
@ -153,7 +153,7 @@ public:
* Note that it is not necessary to call * Note that it is not necessary to call
* this on normal completion of the animation. * this on normal completion of the animation.
* *
* @arg id the id of the animation as returned by moveItem * @param id the id of the animation as returned by moveItem
* @deprecated use new Animator API with Qt Kinetic * @deprecated use new Animator API with Qt Kinetic
*/ */
#ifndef KDE_NO_DEPRECATED #ifndef KDE_NO_DEPRECATED
@ -164,11 +164,11 @@ public:
* Starts a custom animation, preventing the need to create a timeline * Starts a custom animation, preventing the need to create a timeline
* with its own timer tick. * with its own timer tick.
* *
* @arg frames the number of frames this animation should persist for * @param frames the number of frames this animation should persist for
* @arg duration the length, in milliseconds, the animation will take * @param duration the length, in milliseconds, the animation will take
* @arg curve the curve applied to the frame rate * @param curve the curve applied to the frame rate
* @arg receive the object that will handle the actual animation * @param receive the object that will handle the actual animation
* @arg method the method name of slot to be invoked on each update. * @param method the method name of slot to be invoked on each update.
* It must take a qreal. So if the slot is animate(qreal), * It must take a qreal. So if the slot is animate(qreal),
* pass in "animate" as the method parameter. * pass in "animate" as the method parameter.
* It has an optional integer paramenter that takes an * It has an optional integer paramenter that takes an
@ -188,7 +188,7 @@ public:
* this on object destruction, as custom animations associated with * this on object destruction, as custom animations associated with
* a given QObject are cleaned up automatically on QObject destruction. * a given QObject are cleaned up automatically on QObject destruction.
* *
* @arg id the id of the animation as returned by customAnimation * @param id the id of the animation as returned by customAnimation
* @deprecated use new Animator API with Qt Kinetic * @deprecated use new Animator API with Qt Kinetic
*/ */
#ifndef KDE_NO_DEPRECATED #ifndef KDE_NO_DEPRECATED

6
applet.h
View File

@ -337,7 +337,7 @@ class PLASMA_EXPORT Applet : public QGraphicsWidget
/** /**
* Sets the list of custom categories that are used in addition to the default * Sets the list of custom categories that are used in addition to the default
* set of categories known to libplasma for Applets. * set of categories known to libplasma for Applets.
* @arg categories a list of categories * @param categories a list of categories
* @since 4.3 * @since 4.3
*/ */
void setCustomCategories(const QStringList &categories); void setCustomCategories(const QStringList &categories);
@ -804,7 +804,7 @@ class PLASMA_EXPORT Applet : public QGraphicsWidget
/** /**
* Sets the immutability type for this applet (not immutable, * Sets the immutability type for this applet (not immutable,
* user immutable or system immutable) * user immutable or system immutable)
* @arg immutable the new immutability type of this applet * @param immutable the new immutability type of this applet
*/ */
void setImmutability(const ImmutabilityType immutable); void setImmutability(const ImmutabilityType immutable);
@ -833,7 +833,7 @@ class PLASMA_EXPORT Applet : public QGraphicsWidget
* Actually show your custom configuration interface * Actually show your custom configuration interface
* Use this only if you reimplemented showConfigurationInterface() * Use this only if you reimplemented showConfigurationInterface()
* *
* @arg widget the widget representing your configuration interface * @param widget the widget representing your configuration interface
* *
* @since 4.5 * @since 4.5
*/ */

4
configloader.h
View File

@ -109,8 +109,8 @@ public:
/** /**
* Finds the item for the given group and key. * Finds the item for the given group and key.
* *
* @arg group the group in the config file to look in * @param group the group in the config file to look in
* @arg key the configuration key to find * @param key the configuration key to find
* @return the associated KConfigSkeletonItem, or 0 if none * @return the associated KConfigSkeletonItem, or 0 if none
*/ */
KConfigSkeletonItem *findItem(const QString &group, const QString &key); KConfigSkeletonItem *findItem(const QString &group, const QString &key);

4
containment.h
View File

@ -303,7 +303,7 @@ class PLASMA_EXPORT Containment : public Applet
/** /**
* Sets the open or closed state of the Containment's toolbox * Sets the open or closed state of the Containment's toolbox
* *
* @arg open true to open the ToolBox, false to close it * @param open true to open the ToolBox, false to close it
*/ */
void setToolBoxOpen(bool open); void setToolBoxOpen(bool open);
@ -523,7 +523,7 @@ Q_SIGNALS:
* it will be removed nicely and deleted. * it will be removed nicely and deleted.
* Its configuration will also be deleted. * Its configuration will also be deleted.
* *
* @arg confirm whether or not confirmation from the user should be requested * @param confirm whether or not confirmation from the user should be requested
*/ */
void destroy(bool confirm); void destroy(bool confirm);

4
containmentactions.h
View File

@ -204,8 +204,8 @@ class PLASMA_EXPORT ContainmentActions : public QObject
/** /**
* Returns a popup position appropriate to the event and the size. * Returns a popup position appropriate to the event and the size.
* *
* @arg s size of the popup * @param s size of the popup
* @arg event a pointer to the event that triggered the popup * @param event a pointer to the event that triggered the popup
* @return the preferred top-left position for the popup * @return the preferred top-left position for the popup
* @since 4.6 * @since 4.6
*/ */

12
corona.h
View File

@ -340,7 +340,7 @@ public Q_SLOTS:
/** /**
* Save applets layout to file * Save applets layout to file
* @arg config the file to save to, or the default config file if QString() * @param config the file to save to, or the default config file if QString()
*/ */
void saveLayout(const QString &config = QString()) const; void saveLayout(const QString &config = QString()) const;
@ -352,7 +352,7 @@ public Q_SLOTS:
/** /**
* Sets the immutability type for this Corona (not immutable, * Sets the immutability type for this Corona (not immutable,
* user immutable or system immutable) * user immutable or system immutable)
* @arg immutable the new immutability type of this applet * @param immutable the new immutability type of this applet
*/ */
void setImmutability(const ImmutabilityType immutable); void setImmutability(const ImmutabilityType immutable);
@ -462,8 +462,8 @@ protected:
/** /**
* Maps a stock animation to one of the semantic animations. Used to control things such * Maps a stock animation to one of the semantic animations. Used to control things such
* as what animation is used to make a Plasma::Appear appear in a containment. * as what animation is used to make a Plasma::Appear appear in a containment.
* @arg from the animation to map a new value to * @param from the animation to map a new value to
* @arg to the animation value to map to from * @param to the animation value to map to from
* @since 4.5 * @since 4.5
*/ */
void mapAnimation(Animator::Animation from, Animator::Animation to); void mapAnimation(Animator::Animation from, Animator::Animation to);
@ -471,8 +471,8 @@ protected:
/** /**
* Maps a loadable animation to one of the semantic animations. Used to control things such * Maps a loadable animation to one of the semantic animations. Used to control things such
* as what animation is used to make a Plasma::Appear appear in a containment. * as what animation is used to make a Plasma::Appear appear in a containment.
* @arg from the animation to map a new value to * @param from the animation to map a new value to
* @arg to the animation value to map to from; this must map to a Javascript animation * @param to the animation value to map to from; this must map to a Javascript animation
* @since 4.5 * @since 4.5
*/ */
void mapAnimation(Animator::Animation from, const QString &to); void mapAnimation(Animator::Animation from, const QString &to);

8
dialog.h
View File

@ -66,8 +66,8 @@ class PLASMA_EXPORT Dialog : public QWidget
Q_DECLARE_FLAGS(ResizeCorners, ResizeCorner) Q_DECLARE_FLAGS(ResizeCorners, ResizeCorner)
/** /**
* @arg parent the parent widget, for plasmoids, this is usually 0. * @param parent the parent widget, for plasmoids, this is usually 0.
* @arg f the Qt::WindowFlags, default is to not show a windowborder. * @param f the Qt::WindowFlags, default is to not show a windowborder.
*/ */
explicit Dialog(QWidget * parent = 0, Qt::WindowFlags f = Qt::Window); explicit Dialog(QWidget * parent = 0, Qt::WindowFlags f = Qt::Window);
virtual ~Dialog(); virtual ~Dialog();
@ -77,7 +77,7 @@ class PLASMA_EXPORT Dialog : public QWidget
* The dialog will then set up a QGraphicsView and coordinate geometry with * The dialog will then set up a QGraphicsView and coordinate geometry with
* the widget automatically. * the widget automatically.
* *
* @arg widget the QGraphicsWidget to display in this dialog * @param widget the QGraphicsWidget to display in this dialog
*/ */
void setGraphicsWidget(QGraphicsWidget *widget); void setGraphicsWidget(QGraphicsWidget *widget);
@ -87,7 +87,7 @@ class PLASMA_EXPORT Dialog : public QWidget
QGraphicsWidget *graphicsWidget(); QGraphicsWidget *graphicsWidget();
/** /**
* @arg corners the corners the resize handlers should be placed in. * @param corners the corners the resize handlers should be placed in.
*/ */
void setResizeHandleCorners(ResizeCorners corners); void setResizeHandleCorners(ResizeCorners corners);

40
framesvg.h
View File

@ -99,7 +99,7 @@ class PLASMA_EXPORT FrameSvg : public Svg
* as borders. It may also be used as a regular Plasma::Svg object * as borders. It may also be used as a regular Plasma::Svg object
* for direct access to elements in the Svg. * for direct access to elements in the Svg.
* *
* @arg parent options QObject to parent this to * @param parent options QObject to parent this to
* *
* @related Plasma::Theme * @related Plasma::Theme
*/ */
@ -108,13 +108,13 @@ class PLASMA_EXPORT FrameSvg : public Svg
/** /**
* Loads a new Svg * Loads a new Svg
* @arg imagePath the new file * @param imagePath the new file
*/ */
Q_INVOKABLE void setImagePath(const QString &path); Q_INVOKABLE void setImagePath(const QString &path);
/** /**
* Sets what borders should be painted * Sets what borders should be painted
* @arg flags borders we want to paint * @param flags borders we want to paint
*/ */
void setEnabledBorders(const EnabledBorders borders); void setEnabledBorders(const EnabledBorders borders);
@ -126,7 +126,7 @@ class PLASMA_EXPORT FrameSvg : public Svg
/** /**
* Resize the frame maintaining the same border size * Resize the frame maintaining the same border size
* @arg size the new size of the frame * @param size the new size of the frame
*/ */
Q_INVOKABLE void resizeFrame(const QSizeF &size); Q_INVOKABLE void resizeFrame(const QSizeF &size);
@ -137,7 +137,7 @@ class PLASMA_EXPORT FrameSvg : public Svg
/** /**
* Returns the margin size given the margin edge we want * Returns the margin size given the margin edge we want
* @arg edge the margin edge we want, top, bottom, left or right * @param edge the margin edge we want, top, bottom, left or right
* @return the margin size * @return the margin size
*/ */
Q_INVOKABLE qreal marginSize(const Plasma::MarginEdge edge) const; Q_INVOKABLE qreal marginSize(const Plasma::MarginEdge edge) const;
@ -145,10 +145,10 @@ class PLASMA_EXPORT FrameSvg : public Svg
/** /**
* Convenience method that extracts the size of the four margins * Convenience method that extracts the size of the four margins
* in the four output parameters * in the four output parameters
* @arg left left margin size * @param left left margin size
* @arg top top margin size * @param top top margin size
* @arg right right margin size * @param right right margin size
* @arg bottom bottom margin size * @param bottom bottom margin size
*/ */
Q_INVOKABLE void getMargins(qreal &left, qreal &top, qreal &right, qreal &bottom) const; Q_INVOKABLE void getMargins(qreal &left, qreal &top, qreal &right, qreal &bottom) const;
@ -164,7 +164,7 @@ class PLASMA_EXPORT FrameSvg : public Svg
* *
* The prefix must exist in the SVG document, which means that this can only be * The prefix must exist in the SVG document, which means that this can only be
* called successfully after setImagePath is called. * called successfully after setImagePath is called.
* @arg location location in the UI this frame will be drawn * @param location location in the UI this frame will be drawn
*/ */
Q_INVOKABLE void setElementPrefix(Plasma::Location location); Q_INVOKABLE void setElementPrefix(Plasma::Location location);
@ -182,14 +182,14 @@ class PLASMA_EXPORT FrameSvg : public Svg
* The prefix must exist in the SVG document, which means that this can only be * The prefix must exist in the SVG document, which means that this can only be
* called successfully after setImagePath is called. * called successfully after setImagePath is called.
* *
* @arg prefix prefix for the SVG elements that make up the frame * @param prefix prefix for the SVG elements that make up the frame
*/ */
Q_INVOKABLE void setElementPrefix(const QString & prefix); Q_INVOKABLE void setElementPrefix(const QString & prefix);
/** /**
* @return true if the svg has the necessary elements with the given prefix * @return true if the svg has the necessary elements with the given prefix
* to draw a frame * to draw a frame
* @arg prefix the given prefix we want to check if drawable * @param prefix the given prefix we want to check if drawable
*/ */
Q_INVOKABLE bool hasElementPrefix(const QString & prefix) const; Q_INVOKABLE bool hasElementPrefix(const QString & prefix) const;
@ -199,7 +199,7 @@ class PLASMA_EXPORT FrameSvg : public Svg
* hasElementPrefix("west") and hasElementPrefix("east") * hasElementPrefix("west") and hasElementPrefix("east")
* @return true if the svg has the necessary elements with the given prefix * @return true if the svg has the necessary elements with the given prefix
* to draw a frame. * to draw a frame.
* @arg location the given prefix we want to check if drawable * @param location the given prefix we want to check if drawable
*/ */
Q_INVOKABLE bool hasElementPrefix(Plasma::Location location) const; Q_INVOKABLE bool hasElementPrefix(Plasma::Location location) const;
@ -222,7 +222,7 @@ class PLASMA_EXPORT FrameSvg : public Svg
/** /**
* Sets whether saving all the rendered prefixes in a cache or not * Sets whether saving all the rendered prefixes in a cache or not
* @arg cache if use the cache or not * @param cache if use the cache or not
*/ */
Q_INVOKABLE void setCacheAllRenderedFrames(bool cache); Q_INVOKABLE void setCacheAllRenderedFrames(bool cache);
@ -241,7 +241,7 @@ class PLASMA_EXPORT FrameSvg : public Svg
/** /**
* Returns a pixmap of the SVG represented by this object. * Returns a pixmap of the SVG represented by this object.
* *
* @arg elelementId the ID string of the element to render, or an empty * @param elelementId the ID string of the element to render, or an empty
* string for the whole SVG (the default) * string for the whole SVG (the default)
* @return a QPixmap of the rendered SVG * @return a QPixmap of the rendered SVG
*/ */
@ -249,9 +249,9 @@ class PLASMA_EXPORT FrameSvg : public Svg
/** /**
* Paints the loaded SVG with the elements that represents the border * Paints the loaded SVG with the elements that represents the border
* @arg painter the QPainter to use * @param painter the QPainter to use
* @arg target the target rectangle on the paint device * @param target the target rectangle on the paint device
* @arg source the portion rectangle of the source image * @param source the portion rectangle of the source image
*/ */
Q_INVOKABLE void paintFrame(QPainter *painter, const QRectF &target, Q_INVOKABLE void paintFrame(QPainter *painter, const QRectF &target,
const QRectF &source = QRectF()); const QRectF &source = QRectF());
@ -259,8 +259,8 @@ class PLASMA_EXPORT FrameSvg : public Svg
/** /**
* Paints the loaded SVG with the elements that represents the border * Paints the loaded SVG with the elements that represents the border
* This is an overloaded member provided for convenience * This is an overloaded member provided for convenience
* @arg painter the QPainter to use * @param painter the QPainter to use
* @arg pos where to paint the svg * @param pos where to paint the svg
*/ */
Q_INVOKABLE void paintFrame(QPainter *painter, const QPointF &pos = QPointF(0, 0)); Q_INVOKABLE void paintFrame(QPainter *painter, const QPointF &pos = QPointF(0, 0));

10
glapplet.h
View File

@ -40,10 +40,10 @@ class PLASMA_EXPORT_DEPRECATED GLApplet : public Applet
public: public:
/** /**
* @arg parent the QGraphicsItem this applet is parented to * @param parent the QGraphicsItem this applet is parented to
* @arg serviceId the name of the .desktop file containing the * @param serviceId the name of the .desktop file containing the
* information about the widget * information about the widget
* @arg appletId a unique id used to differentiate between multiple * @param appletId a unique id used to differentiate between multiple
* instances of the same Applet type * instances of the same Applet type
*/ */
GLApplet(QGraphicsItem *parent, GLApplet(QGraphicsItem *parent,
@ -56,8 +56,8 @@ class PLASMA_EXPORT_DEPRECATED GLApplet : public Applet
* to have two elements: the KService service ID for the desktop entry * to have two elements: the KService service ID for the desktop entry
* and an applet ID which must be a base 10 number. * and an applet ID which must be a base 10 number.
* *
* @arg parent a QObject parent; you probably want to pass in 0 * @param parent a QObject parent; you probably want to pass in 0
* @arg args a list of strings containing two entries: the service id * @param args a list of strings containing two entries: the service id
* and the applet id * and the applet id
*/ */
GLApplet(QObject *parent, const QVariantList &args); GLApplet(QObject *parent, const QVariantList &args);

30
package.h
View File

@ -51,9 +51,9 @@ class PLASMA_EXPORT Package
/** /**
* Construct a Package object * Construct a Package object
* *
* @arg packageRoot path to the package installation root * @param packageRoot path to the package installation root
* @arg package the name of the package * @param package the name of the package
* @arg structure the package structure describing this package * @param structure the package structure describing this package
**/ **/
Package(const QString &packageRoot, const QString &package, Package(const QString &packageRoot, const QString &package,
PackageStructure::Ptr structure); PackageStructure::Ptr structure);
@ -61,8 +61,8 @@ class PLASMA_EXPORT Package
/** /**
* Construct a Package object. * Construct a Package object.
* *
* @arg packagePath full path to the package directory * @param packagePath full path to the package directory
* @arg structure the package structure describing this package * @param structure the package structure describing this package
*/ */
Package(const QString &packagePath, PackageStructure::Ptr structure); Package(const QString &packagePath, PackageStructure::Ptr structure);
@ -89,9 +89,9 @@ class PLASMA_EXPORT Package
/** /**
* Get the path to a given file. * Get the path to a given file.
* *
* @arg fileType the type of file to look for, as defined in the * @param fileType the type of file to look for, as defined in the
* package structure * package structure
* @arg filename the name of the file * @param filename the name of the file
* @return path to the file on disk. QString() if not found. * @return path to the file on disk. QString() if not found.
**/ **/
QString filePath(const char *fileType, const QString &filename) const; QString filePath(const char *fileType, const QString &filename) const;
@ -99,7 +99,7 @@ class PLASMA_EXPORT Package
/** /**
* Get the path to a given file. * Get the path to a given file.
* *
* @arg fileType the type of file to look for, as defined in the * @param fileType the type of file to look for, as defined in the
* package structure. The type must refer to a file * package structure. The type must refer to a file
* in the package structure and not a directory. * in the package structure and not a directory.
* @return path to the file on disk. QString() if not found * @return path to the file on disk. QString() if not found
@ -109,7 +109,7 @@ class PLASMA_EXPORT Package
/** /**
* Get the list of files of a given type. * Get the list of files of a given type.
* *
* @arg fileType the type of file to look for, as defined in the * @param fileType the type of file to look for, as defined in the
* package structure. * package structure.
* @return list of files by name, suitable for passing to filePath * @return list of files by name, suitable for passing to filePath
**/ **/
@ -122,7 +122,7 @@ class PLASMA_EXPORT Package
/** /**
* Sets the path to the root of this package * Sets the path to the root of this package
* @arg path and absolute path * @param path and absolute path
* @since 4.3 * @since 4.3
*/ */
void setPath(const QString &path); void setPath(const QString &path);
@ -210,7 +210,7 @@ class PLASMA_EXPORT Package
/** /**
* Registers a package described by the given desktop file * Registers a package described by the given desktop file
* *
* @arg the full path to the desktop file (must be KPluginInfo compatible) * @param the full path to the desktop file (must be KPluginInfo compatible)
* @return true on success, false on failure * @return true on success, false on failure
*/ */
static bool registerPackage(const PackageMetadata &data, const QString &iconPath); static bool registerPackage(const PackageMetadata &data, const QString &iconPath);
@ -219,11 +219,11 @@ class PLASMA_EXPORT Package
* Creates a package based on the metadata from the files contained * Creates a package based on the metadata from the files contained
* in the source directory * in the source directory
* *
* @arg metadata description of the package to create * @param metadata description of the package to create
* @arg source path to local directory containing the individual * @param source path to local directory containing the individual
* files to be added to the package * files to be added to the package
* @arg destination path to the package that should be created * @param destination path to the package that should be created
* @arg icon path to the package icon * @param icon path to the package icon
**/ **/
static bool createPackage(const PackageMetadata &metadata, static bool createPackage(const PackageMetadata &metadata,
const QString &source, const QString &source,

4
packagemetadata.h
View File

@ -63,7 +63,7 @@ public:
* with KPluginInfo * with KPluginInfo
* @see KPluginInfo * @see KPluginInfo
* *
* @arg filename path to the file to write to * @param filename path to the file to write to
**/ **/
void write(const QString &filename) const; void write(const QString &filename) const;
@ -73,7 +73,7 @@ public:
* with KPluginInfo * with KPluginInfo
* @see KPluginInfo * @see KPluginInfo
* *
* @arg filename path to the file to write to * @param filename path to the file to write to
**/ **/
void read(const QString &filename); void read(const QString &filename);

16
packagestructure.h
View File

@ -79,7 +79,7 @@ public:
/** /**
* Default constructor for a package structure definition * Default constructor for a package structure definition
* *
* @arg type the type of package. This is often application specific. * @param type the type of package. This is often application specific.
**/ **/
explicit PackageStructure(QObject *parent = 0, explicit PackageStructure(QObject *parent = 0,
const QString &type = i18nc("A non-functional package", "Invalid")); const QString &type = i18nc("A non-functional package", "Invalid"));
@ -97,7 +97,7 @@ public:
/** /**
* Loads a package format by name. * Loads a package format by name.
* *
* @arg format If not empty, attempts to locate the given format, either * @param format If not empty, attempts to locate the given format, either
* from built-ins or via plugins. * from built-ins or via plugins.
* @return a package that matches the format, if available. The caller * @return a package that matches the format, if available. The caller
* is responsible for deleting the object. * is responsible for deleting the object.
@ -179,7 +179,7 @@ public:
/** /**
* Get the list of files of a given type. * Get the list of files of a given type.
* *
* @arg key the type of file to look for * @param key the type of file to look for
* @return list of files by name * @return list of files by name
* @since 4.3 * @since 4.3
*/ */
@ -264,8 +264,8 @@ public:
/** /**
* Uninstalls a package matching this package structure. * Uninstalls a package matching this package structure.
* *
* @arg packageName the name of the package to remove * @param packageName the name of the package to remove
* @arg packageRoot path to the directory where the package should be installed to * @param packageRoot path to the directory where the package should be installed to
* @return true on successful removal of the package, false otherwise * @return true on successful removal of the package, false otherwise
*/ */
virtual bool uninstallPackage(const QString &packageName, const QString &packageRoot); virtual bool uninstallPackage(const QString &packageName, const QString &packageRoot);
@ -332,7 +332,7 @@ Q_SIGNALS:
protected: protected:
/** /**
* Sets whether or not external paths/symlinks can be followed by a package * Sets whether or not external paths/symlinks can be followed by a package
* @arg allow true if paths/symlinks outside of the package should be followed, * @param allow true if paths/symlinks outside of the package should be followed,
* false if they should be rejected. * false if they should be rejected.
*/ */
void setAllowExternalPaths(bool allow); void setAllowExternalPaths(bool allow);
@ -343,7 +343,7 @@ protected:
* between the base path and the entries as defined by the package * between the base path and the entries as defined by the package
* structure * structure
* *
* @arg prefix the directory prefix to use * @param prefix the directory prefix to use
* @deprecated use setContentsPrefixPaths() instead. * @deprecated use setContentsPrefixPaths() instead.
*/ */
KDE_DEPRECATED void setContentsPrefix(const QString &prefix); KDE_DEPRECATED void setContentsPrefix(const QString &prefix);
@ -356,7 +356,7 @@ protected:
* In this case each file request will be searched in all prefixes in order, * In this case each file request will be searched in all prefixes in order,
* and the first found will be returned. * and the first found will be returned.
* *
* @arg prefix paths the directory prefix to use * @param prefix paths the directory prefix to use
* @since 4.6 * @since 4.6
*/ */
void setContentsPrefixPaths(const QStringList &prefixPaths); void setContentsPrefixPaths(const QStringList &prefixPaths);

2
plasma.h
View File

@ -308,7 +308,7 @@ PLASMA_EXPORT Direction locationToInverseDirection(Location location);
/** /**
* Returns the most appropriate QGraphicsView for the item. * Returns the most appropriate QGraphicsView for the item.
* *
* @arg item the QGraphicsItem to locate a view for * @param item the QGraphicsItem to locate a view for
* @return pointer to a view, or 0 if none was found * @return pointer to a view, or 0 if none was found
*/ */
PLASMA_EXPORT QGraphicsView *viewFor(const QGraphicsItem *item); PLASMA_EXPORT QGraphicsView *viewFor(const QGraphicsItem *item);

12
popupapplet.h
View File

@ -59,7 +59,7 @@ public:
~PopupApplet(); ~PopupApplet();
/** /**
* @arg icon the icon that has to be displayed when the applet is in a panel. * @param icon the icon that has to be displayed when the applet is in a panel.
* Passing in a null icon means that the popup applet itself * Passing in a null icon means that the popup applet itself
* will provide an interface for when the PopupApplet is not showing * will provide an interface for when the PopupApplet is not showing
* the widget() or graphicsWidget() directly. * the widget() or graphicsWidget() directly.
@ -67,7 +67,7 @@ public:
void setPopupIcon(const QIcon &icon); void setPopupIcon(const QIcon &icon);
/** /**
* @arg icon the icon that has to be displayed when the applet is in a panel. * @param icon the icon that has to be displayed when the applet is in a panel.
* Passing in an empty QString() means that the popup applet itself * Passing in an empty QString() means that the popup applet itself
* will provide an interface for when the PopupApplet is not showing * will provide an interface for when the PopupApplet is not showing
* the widget() or graphicsWidget() directly. * the widget() or graphicsWidget() directly.
@ -107,7 +107,7 @@ public:
/** /**
* Sets the default alignment of the popup relative to the applet * Sets the default alignment of the popup relative to the applet
* @arg alignment the alignment to use; Qt::AlignLeft or Qt::AlignRight * @param alignment the alignment to use; Qt::AlignLeft or Qt::AlignRight
* @since 4.6 * @since 4.6
*/ */
void setPopupAlignment(Qt::AlignmentFlag alignment); void setPopupAlignment(Qt::AlignmentFlag alignment);
@ -122,7 +122,7 @@ public:
* Sets whether or not the dialog popup that gets created should be a "passive" popup * Sets whether or not the dialog popup that gets created should be a "passive" popup
* that does not steal focus from other windows or not. * that does not steal focus from other windows or not.
* *
* @arg passive true if the dialog should be treated as a passive popup * @param passive true if the dialog should be treated as a passive popup
*/ */
void setPassivePopup(bool passive); void setPassivePopup(bool passive);
@ -151,7 +151,7 @@ public Q_SLOTS:
/** /**
* Shows the dialog showing the widget if the applet is in a panel. * Shows the dialog showing the widget if the applet is in a panel.
* @arg displayTime the time in ms that the popup should be displayed, defaults to 0 which means * @param displayTime the time in ms that the popup should be displayed, defaults to 0 which means
* always (until the user closes it again, that is). * always (until the user closes it again, that is).
*/ */
void showPopup(uint displayTime = 0); void showPopup(uint displayTime = 0);
@ -165,7 +165,7 @@ protected:
/** /**
* This event handler can be reimplemented in a subclass to receive an * This event handler can be reimplemented in a subclass to receive an
* event before the popup is shown or hidden. * event before the popup is shown or hidden.
* @arg show true if the popup is going to be shown, false if the popup * @param show true if the popup is going to be shown, false if the popup
* is going to be hidden. * is going to be hidden.
* Note that showing and hiding the popup on click is already done in PopupApplet. * Note that showing and hiding the popup on click is already done in PopupApplet.
*/ */

4
remote/accessappletjob.h
View File

@ -52,8 +52,8 @@ protected:
/** /**
* Default constructor * Default constructor
* *
* @arg location the location of the service * @param location the location of the service
* @arg parent the parent object for this service * @param parent the parent object for this service
*/ */
AccessAppletJob(const KUrl &location, QObject *parent = 0); AccessAppletJob(const KUrl &location, QObject *parent = 0);

4
remote/serviceaccessjob.h
View File

@ -52,8 +52,8 @@ protected:
/** /**
* Default constructor * Default constructor
* *
* @arg location the location of the service * @param location the location of the service
* @arg parent the parent object for this service * @param parent the parent object for this service
*/ */
ServiceAccessJob(KUrl location, QObject *parent = 0); ServiceAccessJob(KUrl location, QObject *parent = 0);

8
runnercontext.h
View File

@ -146,8 +146,8 @@ class PLASMA_EXPORT RunnerContext : public QObject
* *
* If you are going to be adding multiple matches, use addMatches instead. * If you are going to be adding multiple matches, use addMatches instead.
* *
* @arg term the search term that this match was generated for. * @param term the search term that this match was generated for.
* @arg match the match to add * @param match the match to add
* *
* @return true if the match was added, false otherwise. * @return true if the match was added, false otherwise.
*/ */
@ -160,7 +160,7 @@ class PLASMA_EXPORT RunnerContext : public QObject
* *
* If you are going to be removing multiple matches, use removeMatches instead. * If you are going to be removing multiple matches, use removeMatches instead.
* *
* @arg matchId the id of match to remove * @param matchId the id of match to remove
* *
* @return true if the match was removed, false otherwise. * @return true if the match was removed, false otherwise.
* @since 4.4 * @since 4.4
@ -172,7 +172,7 @@ class PLASMA_EXPORT RunnerContext : public QObject
* *
* This method is thread safe and causes the matchesChanged() signal to be emitted. * This method is thread safe and causes the matchesChanged() signal to be emitted.
* *
* @arg matchIdList the list of matches id to remove * @param matchIdList the list of matches id to remove
* *
* @return true if at least one match was removed, false otherwise. * @return true if at least one match was removed, false otherwise.
* @since 4.4 * @since 4.4

26
runnermanager.h
View File

@ -57,7 +57,7 @@ class PLASMA_EXPORT RunnerManager : public QObject
/** /**
* Finds and returns a loaded runner or NULL * Finds and returns a loaded runner or NULL
* @arg name the name of the runner * @param name the name of the runner
* @return Pointer to the runner * @return Pointer to the runner
*/ */
AbstractRunner *runner(const QString &name) const; AbstractRunner *runner(const QString &name) const;
@ -73,7 +73,7 @@ class PLASMA_EXPORT RunnerManager : public QObject
* runner; if the runner does not exist or can not be loaded then * runner; if the runner does not exist or can not be loaded then
* the single runner mode will not be started and singleModeRunner() * the single runner mode will not be started and singleModeRunner()
* will return NULL * will return NULL
* @arg id the id of the runner to use * @param id the id of the runner to use
* @since 4.4 * @since 4.4
*/ */
void setSingleModeRunnerId(const QString &id); void setSingleModeRunnerId(const QString &id);
@ -93,14 +93,14 @@ class PLASMA_EXPORT RunnerManager : public QObject
/** /**
* Sets whether or not the manager is in single mode. * Sets whether or not the manager is in single mode.
* *
* @arg singleMode true if the manager should be in single mode, false otherwise * @param singleMode true if the manager should be in single mode, false otherwise
* @since 4.4 * @since 4.4
*/ */
void setSingleMode(bool singleMode); void setSingleMode(bool singleMode);
/** /**
* Returns the translated name of a runner * Returns the translated name of a runner
* @arg id the id of the runner * @param id the id of the runner
* *
* @since 4.4 * @since 4.4
*/ */
@ -131,13 +131,13 @@ class PLASMA_EXPORT RunnerManager : public QObject
/** /**
* Runs a given match * Runs a given match
* @arg match the match to be executed * @param match the match to be executed
*/ */
void run(const QueryMatch &match); void run(const QueryMatch &match);
/** /**
* Runs a given match * Runs a given match
* @arg id the id of the match to run * @param id the id of the match to run
*/ */
void run(const QString &id); void run(const QString &id);
@ -159,7 +159,7 @@ class PLASMA_EXPORT RunnerManager : public QObject
/** /**
* Sets a whitelist for the plugins that can be loaded * Sets a whitelist for the plugins that can be loaded
* *
* @arg plugins the plugin names of allowed runners * @param plugins the plugin names of allowed runners
* @since 4.4 * @since 4.4
*/ */
void setAllowedRunners(const QStringList &runners); void setAllowedRunners(const QStringList &runners);
@ -171,7 +171,7 @@ class PLASMA_EXPORT RunnerManager : public QObject
* but in cases where specific runners should be loaded this * but in cases where specific runners should be loaded this
* allows for that to take place * allows for that to take place
* *
* @arg service the service to use to load the plugin * @param service the service to use to load the plugin
* @since 4.5 * @since 4.5
*/ */
void loadRunner(const KService::Ptr service); void loadRunner(const KService::Ptr service);
@ -182,7 +182,7 @@ class PLASMA_EXPORT RunnerManager : public QObject
* handle loading Runner plugins, but in cases where specific * handle loading Runner plugins, but in cases where specific
* runners should be loaded this allows for that to take place * runners should be loaded this allows for that to take place
* *
* @arg path the path to a Runner package to load * @param path the path to a Runner package to load
* @since 4.5 * @since 4.5
*/ */
void loadRunner(const QString &path); void loadRunner(const QString &path);
@ -241,8 +241,8 @@ class PLASMA_EXPORT RunnerManager : public QObject
* When the information will be available can be known using the * When the information will be available can be known using the
* matchesChanged signal. * matchesChanged signal.
* *
* @arg term the term we want to find matches for * @param term the term we want to find matches for
* @arg runnerId optional, if only one specific runner is to be used; * @param runnerId optional, if only one specific runner is to be used;
* providing an id will put the manager into single runner mode * providing an id will put the manager into single runner mode
*/ */
void launchQuery(const QString &term, const QString &runnerId); void launchQuery(const QString &term, const QString &runnerId);
@ -257,8 +257,8 @@ class PLASMA_EXPORT RunnerManager : public QObject
* This means that the method may be dangerous as it wait a variable amount * This means that the method may be dangerous as it wait a variable amount
* of time for the runner to finish. * of time for the runner to finish.
* The runner parameter is mandatory, to avoid launching unwanted runners. * The runner parameter is mandatory, to avoid launching unwanted runners.
* @arg term the term we want to find matches for * @param term the term we want to find matches for
* @arg runner the runner we will use, it is mandatory * @param runner the runner we will use, it is mandatory
* @return 0 if nothing was launched, 1 if launched. * @return 0 if nothing was launched, 1 if launched.
*/ */
bool execQuery(const QString &term, const QString &runnerName); bool execQuery(const QString &term, const QString &runnerName);

6
runnersyntax.h
View File

@ -43,11 +43,11 @@ class PLASMA_EXPORT RunnerSyntax
/** /**
* Constructs a simple syntax object * Constructs a simple syntax object
* *
* @arg exampleQuery an example of the query, with :q: placed wherever * @param exampleQuery an example of the query, with :q: placed wherever
* search term text might appear. e.g. if the runner * search term text might appear. e.g. if the runner
* accepts "keyword some random text" then the value * accepts "keyword some random text" then the value
* of this parameter should be "keyword :q:" * of this parameter should be "keyword :q:"
* @arg descrition A description of what the described syntax does from * @param descrition A description of what the described syntax does from
* the user's point of view. * the user's point of view.
*/ */
RunnerSyntax(const QString &exampleQuery, const QString &description); RunnerSyntax(const QString &exampleQuery, const QString &description);
@ -70,7 +70,7 @@ class PLASMA_EXPORT RunnerSyntax
* This allows the runner to show these relationships by grouping the * This allows the runner to show these relationships by grouping the
* example queries into one Syntax object * example queries into one Syntax object
* *
* @arg exampleQuery an example of the query, with :q: placed wherever * @param exampleQuery an example of the query, with :q: placed wherever
* search term text might appear. e.g. if the runner * search term text might appear. e.g. if the runner
* accepts "keyword some random text" then the value * accepts "keyword some random text" then the value
* of this parameter should be "keyword :q:" * of this parameter should be "keyword :q:"

6
scripting/appletscript.h
View File

@ -120,7 +120,7 @@ public:
/** /**
* Sets whether or not this script has a configuration interface or not * Sets whether or not this script has a configuration interface or not
* *
* @arg hasInterface true if the applet is user configurable * @param hasInterface true if the applet is user configurable
*/ */
void setHasConfigurationInterface(bool hasInterface); void setHasConfigurationInterface(bool hasInterface);
@ -195,7 +195,7 @@ public Q_SLOTS:
protected: protected:
/** /**
* @arg engine name of the engine * @param engine name of the engine
* @return a data engine associated with this plasmoid * @return a data engine associated with this plasmoid
*/ */
Q_INVOKABLE DataEngine *dataEngine(const QString &engine) const; Q_INVOKABLE DataEngine *dataEngine(const QString &engine) const;
@ -255,7 +255,7 @@ protected:
/** /**
* Loads an animation from the applet package * Loads an animation from the applet package
* @arg animation the animation to load * @param animation the animation to load
* @return an Animation object on success, a NULL pointer on failure * @return an Animation object on success, a NULL pointer on failure
* @since 4.5 * @since 4.5
*/ */

2
scripting/scriptengine.h
View File

@ -94,7 +94,7 @@ private:
}; };
/** /**
* @arg types a set of ComponentTypes flags for which to look up the * @param types a set of ComponentTypes flags for which to look up the
* language support for * language support for
* @return a list of all supported languages for the given type(s). * @return a list of all supported languages for the given type(s).
**/ **/

8
service.h
View File

@ -133,7 +133,7 @@ public:
/** /**
* Sets the destination for this Service to operate on * Sets the destination for this Service to operate on
* *
* @arg destination specific to each Service, this sets which * @param destination specific to each Service, this sets which
* target or address for ServiceJobs to operate on * target or address for ServiceJobs to operate on
*/ */
Q_INVOKABLE void setDestination(const QString &destination); Q_INVOKABLE void setDestination(const QString &destination);
@ -224,7 +224,7 @@ public:
/** /**
* @return a parameter map for the given description * @return a parameter map for the given description
* @arg description the configuration values to turn into the parameter map * @param description the configuration values to turn into the parameter map
* @since 4.4 * @since 4.4
*/ */
Q_INVOKABLE QMap<QString, QVariant> parametersFromDescription(const KConfigGroup &description); Q_INVOKABLE QMap<QString, QVariant> parametersFromDescription(const KConfigGroup &description);
@ -251,7 +251,7 @@ protected:
/** /**
* Default constructor * Default constructor
* *
* @arg parent the parent object for this service * @param parent the parent object for this service
*/ */
explicit Service(QObject *parent = 0); explicit Service(QObject *parent = 0);
@ -288,7 +288,7 @@ protected:
* Sets the name of the Service; useful for Services not loaded from plugins, * Sets the name of the Service; useful for Services not loaded from plugins,
* which use the plugin name for this. * which use the plugin name for this.
* *
* @arg name the name to use for this service * @param name the name to use for this service
*/ */
void setName(const QString &name); void setName(const QString &name);

8
servicejob.h
View File

@ -63,10 +63,10 @@ public:
/** /**
* Default constructor * Default constructor
* *
* @arg destination the subject that the job is acting on * @param destination the subject that the job is acting on
* @arg operation the action that the job is performing on the @p destination * @param operation the action that the job is performing on the @p destination
* @arg parameters the parameters of the @p action * @param parameters the parameters of the @p action
* @arg parent the parent object for this service * @param parent the parent object for this service
*/ */
ServiceJob(const QString &destination, const QString &operation, ServiceJob(const QString &destination, const QString &operation,
const QMap<QString, QVariant> &parameters, QObject *parent = 0); const QMap<QString, QVariant> &parameters, QObject *parent = 0);

56
svg.h
View File

@ -73,7 +73,7 @@ class PLASMA_EXPORT Svg : public QObject
* *
* The size is initialized to be the SVG's native size. * The size is initialized to be the SVG's native size.
* *
* @arg parent options QObject to parent this to * @param parent options QObject to parent this to
* *
* @related Plasma::Theme * @related Plasma::Theme
*/ */
@ -88,7 +88,7 @@ class PLASMA_EXPORT Svg : public QObject
* size of the requested element after the whole SVG has been scaled * size of the requested element after the whole SVG has been scaled
* to size(). * to size().
* *
* @arg elementId the ID string of the element to render, or an empty * @param elementId the ID string of the element to render, or an empty
* string for the whole SVG (the default) * string for the whole SVG (the default)
* @return a QPixmap of the rendered SVG * @return a QPixmap of the rendered SVG
*/ */
@ -102,10 +102,10 @@ class PLASMA_EXPORT Svg : public QObject
* be the size of the requested element after the whole SVG has been * be the size of the requested element after the whole SVG has been
* scaled to size(). * scaled to size().
* *
* @arg painter the QPainter to use * @param painter the QPainter to use
* @arg point the position to start drawing; the entire svg will be * @param point the position to start drawing; the entire svg will be
* drawn starting at this point. * drawn starting at this point.
* @arg elementId the ID string of the element to render, or an empty * @param elementId the ID string of the element to render, or an empty
* string for the whole SVG (the default) * string for the whole SVG (the default)
*/ */
Q_INVOKABLE void paint(QPainter *painter, const QPointF &point, Q_INVOKABLE void paint(QPainter *painter, const QPointF &point,
@ -119,10 +119,10 @@ class PLASMA_EXPORT Svg : public QObject
* be the size of the requested element after the whole SVG has been * be the size of the requested element after the whole SVG has been
* scaled to size(). * scaled to size().
* *
* @arg painter the QPainter to use * @param painter the QPainter to use
* @arg x the horizontal coordinate to start painting from * @param x the horizontal coordinate to start painting from
* @arg y the vertical coordinate to start painting from * @param y the vertical coordinate to start painting from
* @arg elementId the ID string of the element to render, or an empty * @param elementId the ID string of the element to render, or an empty
* string for the whole SVG (the default) * string for the whole SVG (the default)
*/ */
Q_INVOKABLE void paint(QPainter *painter, int x, int y, Q_INVOKABLE void paint(QPainter *painter, int x, int y,
@ -131,10 +131,10 @@ class PLASMA_EXPORT Svg : public QObject
/** /**
* Paints all or part of the SVG represented by this object * Paints all or part of the SVG represented by this object
* *
* @arg painter the QPainter to use * @param painter the QPainter to use
* @arg rect the rect to draw into; if smaller than the current size * @param rect the rect to draw into; if smaller than the current size
* the drawing is starting at this point. * the drawing is starting at this point.
* @arg elementId the ID string of the element to render, or an empty * @param elementId the ID string of the element to render, or an empty
* string for the whole SVG (the default) * string for the whole SVG (the default)
*/ */
Q_INVOKABLE void paint(QPainter *painter, const QRectF &rect, Q_INVOKABLE void paint(QPainter *painter, const QRectF &rect,
@ -143,12 +143,12 @@ class PLASMA_EXPORT Svg : public QObject
/** /**
* Paints all or part of the SVG represented by this object * Paints all or part of the SVG represented by this object
* *
* @arg painter the QPainter to use * @param painter the QPainter to use
* @arg x the horizontal coordinate to start painting from * @param x the horizontal coordinate to start painting from
* @arg y the vertical coordinate to start painting from * @param y the vertical coordinate to start painting from
* @arg width the width of the element to draw * @param width the width of the element to draw
* @arg height the height of the element do draw * @param height the height of the element do draw
* @arg elementId the ID string of the element to render, or an empty * @param elementId the ID string of the element to render, or an empty
* string for the whole SVG (the default) * string for the whole SVG (the default)
*/ */
Q_INVOKABLE void paint(QPainter *painter, int x, int y, int width, Q_INVOKABLE void paint(QPainter *painter, int x, int y, int width,
@ -177,8 +177,8 @@ class PLASMA_EXPORT Svg : public QObject
* image will be scaled to this size and each element will be * image will be scaled to this size and each element will be
* scaled appropriately. * scaled appropriately.
* *
* @arg width the new width * @param width the new width
* @arg height the new height * @param height the new height
**/ **/
Q_INVOKABLE void resize(qreal width, qreal height); Q_INVOKABLE void resize(qreal width, qreal height);
@ -192,7 +192,7 @@ class PLASMA_EXPORT Svg : public QObject
* image will be scaled to this size and each element will be * image will be scaled to this size and each element will be
* scaled appropriately. * scaled appropriately.
* *
* @arg size the new size of the image * @param size the new size of the image
**/ **/
Q_INVOKABLE void resize(const QSizeF &size); Q_INVOKABLE void resize(const QSizeF &size);
@ -210,7 +210,7 @@ class PLASMA_EXPORT Svg : public QObject
* has been scaled (see resize()). Note that this is unaffected by * has been scaled (see resize()). Note that this is unaffected by
* the containsMultipleImages property. * the containsMultipleImages property.
* *
* @arg elementId the id of the element to check * @param elementId the id of the element to check
* @return the size of a given element, given the current size of the SVG * @return the size of a given element, given the current size of the SVG
**/ **/
Q_INVOKABLE QSize elementSize(const QString &elementId) const; Q_INVOKABLE QSize elementSize(const QString &elementId) const;
@ -222,7 +222,7 @@ class PLASMA_EXPORT Svg : public QObject
* the SVG has been scaled (see resize()). Note that this is * the SVG has been scaled (see resize()). Note that this is
* unaffected by the containsMultipleImages property. * unaffected by the containsMultipleImages property.
* *
* @arg elementId the id of the element to check * @param elementId the id of the element to check
* @return the current rect of a given element, given the current size of the SVG * @return the current rect of a given element, given the current size of the SVG
**/ **/
Q_INVOKABLE QRectF elementRect(const QString &elementId) const; Q_INVOKABLE QRectF elementRect(const QString &elementId) const;
@ -230,7 +230,7 @@ class PLASMA_EXPORT Svg : public QObject
/** /**
* Check whether an element exists in the loaded SVG. * Check whether an element exists in the loaded SVG.
* *
* @arg elementId the id of the element to check for * @param elementId the id of the element to check for
* @return @c true if the element is defined in the SVG, otherwise @c false * @return @c true if the element is defined in the SVG, otherwise @c false
**/ **/
Q_INVOKABLE bool hasElement(const QString &elementId) const; Q_INVOKABLE bool hasElement(const QString &elementId) const;
@ -242,7 +242,7 @@ class PLASMA_EXPORT Svg : public QObject
* *
* NOTE: not implemented! This will currently return an empty string! * NOTE: not implemented! This will currently return an empty string!
* *
* @arg point a point in SVG co-ordinates * @param point a point in SVG co-ordinates
* @return an empty string * @return an empty string
*/ */
Q_INVOKABLE QString elementAtPoint(const QPoint &point) const; Q_INVOKABLE QString elementAtPoint(const QPoint &point) const;
@ -268,7 +268,7 @@ class PLASMA_EXPORT Svg : public QObject
* affects whether the elements are resized to size() by default. * affects whether the elements are resized to size() by default.
* See paint() and pixmap(). * See paint() and pixmap().
* *
* @arg multiple true if the svg contains multiple images * @param multiple true if the svg contains multiple images
*/ */
void setContainsMultipleImages(bool multiple); void setContainsMultipleImages(bool multiple);
@ -296,7 +296,7 @@ class PLASMA_EXPORT Svg : public QObject
* relative paths will be searched for in the applet's package * relative paths will be searched for in the applet's package
* first. * first.
* *
* @arg svgFilePath either an absolute path to an SVG file, or * @param svgFilePath either an absolute path to an SVG file, or
* an image name * an image name
*/ */
void setImagePath(const QString &svgFilePath); void setImagePath(const QString &svgFilePath);
@ -345,7 +345,7 @@ class PLASMA_EXPORT Svg : public QObject
* *
* This determines how relative image paths are interpreted. * This determines how relative image paths are interpreted.
* *
* @arg theme the theme object to use * @param theme the theme object to use
* @since 4.3 * @since 4.3
*/ */
void setTheme(Plasma::Theme *theme); void setTheme(Plasma::Theme *theme);

42
theme.h
View File

@ -89,15 +89,15 @@ class PLASMA_EXPORT Theme : public QObject
/** /**
* Default constructor. Usually you want to use the singleton instead. * Default constructor. Usually you want to use the singleton instead.
* @see defaultTheme * @see defaultTheme
* @arg parent the parent object * @param parent the parent object
*/ */
explicit Theme(QObject *parent = 0); explicit Theme(QObject *parent = 0);
/** /**
* Construct a theme. Usually you want to use the singleton instead. * Construct a theme. Usually you want to use the singleton instead.
* @see defaultTheme * @see defaultTheme
* @arg themeName the name of the theme to create * @param themeName the name of the theme to create
* @arg parent the parent object * @param parent the parent object
* @since 4.3 * @since 4.3
*/ */
explicit Theme(const QString &themeName, QObject *parent = 0); explicit Theme(const QString &themeName, QObject *parent = 0);
@ -128,7 +128,7 @@ class PLASMA_EXPORT Theme : public QObject
/** /**
* Retrieve the path for an SVG image in the current theme. * Retrieve the path for an SVG image in the current theme.
* *
* @arg name the name of the file in the theme directory (without the * @param name the name of the file in the theme directory (without the
* ".svg" part or a leading slash) * ".svg" part or a leading slash)
* @return the full path to the requested file for the current theme * @return the full path to the requested file for the current theme
*/ */
@ -137,7 +137,7 @@ class PLASMA_EXPORT Theme : public QObject
/** /**
* Retrieves the path for the script file that contains a given * Retrieves the path for the script file that contains a given
* Javascript animation. * Javascript animation.
* @arg the name of the animation * @param the name of the animation
* @return the full path to the script file, or an emptry string on failure * @return the full path to the script file, or an emptry string on failure
* @since 4.5 * @since 4.5
*/ */
@ -146,7 +146,7 @@ class PLASMA_EXPORT Theme : public QObject
/** /**
* Retrieves the default wallpaper associated with this theme. * Retrieves the default wallpaper associated with this theme.
* *
* @arg size the target height and width of the wallpaper; if an invalid size * @param size the target height and width of the wallpaper; if an invalid size
* is passed in, then a default size will be provided instead. * is passed in, then a default size will be provided instead.
* @return the full path to the wallpaper image * @return the full path to the wallpaper image
*/ */
@ -155,7 +155,7 @@ class PLASMA_EXPORT Theme : public QObject
/** /**
* Checks if this theme has an image named in a certain way * Checks if this theme has an image named in a certain way
* *
* @arg name the name of the file in the theme directory (without the * @param name the name of the file in the theme directory (without the
* ".svg" part or a leading slash) * ".svg" part or a leading slash)
* @return true if the image exists for this theme * @return true if the image exists for this theme
*/ */
@ -171,7 +171,7 @@ class PLASMA_EXPORT Theme : public QObject
/** /**
* Returns the text color to be used by items resting on the background * Returns the text color to be used by items resting on the background
* *
* @arg role which role (usage pattern) to get the color for * @param role which role (usage pattern) to get the color for
*/ */
Q_INVOKABLE QColor color(ColorRole role) const; Q_INVOKABLE QColor color(ColorRole role) const;
@ -179,15 +179,15 @@ class PLASMA_EXPORT Theme : public QObject
* Sets the default font to be used with themed items. Defaults to * Sets the default font to be used with themed items. Defaults to
* the application wide default font. * the application wide default font.
* *
* @arg font the new font * @param font the new font
* @arg role which role (usage pattern) to set the font for * @param role which role (usage pattern) to set the font for
*/ */
Q_INVOKABLE void setFont(const QFont &font, FontRole role = DefaultFont); Q_INVOKABLE void setFont(const QFont &font, FontRole role = DefaultFont);
/** /**
* Returns the font to be used by themed items * Returns the font to be used by themed items
* *
* @arg role which role (usage pattern) to get the font for * @param role which role (usage pattern) to get the font for
*/ */
Q_INVOKABLE QFont font(FontRole role) const; Q_INVOKABLE QFont font(FontRole role) const;
@ -205,7 +205,7 @@ class PLASMA_EXPORT Theme : public QObject
* Tells the theme whether to follow the global settings or use application * Tells the theme whether to follow the global settings or use application
* specific settings * specific settings
* *
* @arg useGlobal pass in true to follow the global settings * @param useGlobal pass in true to follow the global settings
*/ */
void setUseGlobalSettings(bool useGlobal); void setUseGlobalSettings(bool useGlobal);
@ -328,9 +328,9 @@ class PLASMA_EXPORT Theme : public QObject
/** /**
* Tries to load the rect of a sub element from a disk cache * Tries to load the rect of a sub element from a disk cache
* *
* @arg image path of the image we want to check * @param image path of the image we want to check
* @arg element sub element we want to retrieve * @param element sub element we want to retrieve
* @arg rect output parameter of the element rect found in cache * @param rect output parameter of the element rect found in cache
* if not found or if we are sure it doesn't exist it will be QRect() * if not found or if we are sure it doesn't exist it will be QRect()
* @return true if the element was found in cache or if we are sure the element doesn't exist * @return true if the element was found in cache or if we are sure the element doesn't exist
**/ **/
@ -339,7 +339,7 @@ class PLASMA_EXPORT Theme : public QObject
/** /**
* Returns a list of all keys of cached rects for the given image. * Returns a list of all keys of cached rects for the given image.
* *
* @arg image path of the image for which the keys should be returned * @param image path of the image for which the keys should be returned
* *
* @return a QStringList whose elements are the entry keys in the rects cache * @return a QStringList whose elements are the entry keys in the rects cache
* *
@ -350,16 +350,16 @@ class PLASMA_EXPORT Theme : public QObject
/** /**
* Inserts a rectangle of a sub element of an image into a disk cache * Inserts a rectangle of a sub element of an image into a disk cache
* *
* @arg image path of the image we want to insert information * @param image path of the image we want to insert information
* @arg element sub element we want insert the rect * @param element sub element we want insert the rect
* @arg rect element rectangle * @param rect element rectangle
**/ **/
void insertIntoRectsCache(const QString& image, const QString &element, const QRectF &rect); void insertIntoRectsCache(const QString& image, const QString &element, const QRectF &rect);
/** /**
* Discards all the information about a given image from the rectangle disk cache * Discards all the information about a given image from the rectangle disk cache
* *
* @arg image the path to the image the cache is assoiated with * @param image the path to the image the cache is assoiated with
**/ **/
void invalidateRectsCache(const QString &image); void invalidateRectsCache(const QString &image);
@ -368,7 +368,7 @@ class PLASMA_EXPORT Theme : public QObject
* the permenant record of it on disk. * the permenant record of it on disk.
* @see invalidateRectsCache * @see invalidateRectsCache
* *
* @arg image the path to the image the cache is assoiated with * @param image the path to the image the cache is assoiated with
*/ */
void releaseRectsCache(const QString &image); void releaseRectsCache(const QString &image);

14
tooltipmanager.h
View File

@ -156,7 +156,7 @@ public:
/** /**
* Sets the current state of the manager. * Sets the current state of the manager.
* @see State * @see State
* @arg state the state to put the manager in * @param state the state to put the manager in
*/ */
void setState(ToolTipManager::State state); void setState(ToolTipManager::State state);
@ -168,9 +168,9 @@ public:
Q_SIGNALS: Q_SIGNALS:
/** /**
* This signal is emitted when a window preview in the tooltip is clicked. * This signal is emitted when a window preview in the tooltip is clicked.
* @arg window the id of the window that was clicked * @param window the id of the window that was clicked
* @arg buttons the mouse buttons involved in the activation * @param buttons the mouse buttons involved in the activation
* @arg modifiers the keyboard modifiers involved in the activation, if any * @param modifiers the keyboard modifiers involved in the activation, if any
* @since 4.4 * @since 4.4
*/ */
void windowPreviewActivated(WId window, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, void windowPreviewActivated(WId window, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers,
@ -178,9 +178,9 @@ Q_SIGNALS:
/** /**
* This signal is emitted when a link in the tooltip is clicked. * This signal is emitted when a link in the tooltip is clicked.
* @arg anchor the achor text (e.g. url) that was clicked on * @param anchor the achor text (e.g. url) that was clicked on
* @arg buttons the mouse buttons involved in the activation * @param buttons the mouse buttons involved in the activation
* @arg modifiers the keyboard modifiers involved in the activation, if any * @param modifiers the keyboard modifiers involved in the activation, if any
* @since 4.4 * @since 4.4
*/ */
void linkActivated(const QString &anchor, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, void linkActivated(const QString &anchor, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers,

18
view.h
View File

@ -53,17 +53,17 @@ public:
* Constructs a view for a given contanment. An Id is automatically * Constructs a view for a given contanment. An Id is automatically
* assigned to the View. * assigned to the View.
* *
* @arg containment the containment to center the view on * @param containment the containment to center the view on
* @arg parent the parent object for this view * @param parent the parent object for this view
*/ */
explicit View(Containment *containment, QWidget *parent = 0); explicit View(Containment *containment, QWidget *parent = 0);
/** /**
* Constructs a view for a given contanment. * Constructs a view for a given contanment.
* *
* @arg containment the containment to center the view on * @param containment the containment to center the view on
* @arg viewId the id to assign to this view * @param viewId the id to assign to this view
* @arg parent the parent object for this view * @param parent the parent object for this view
*/ */
View(Containment *containment, int viewId, QWidget *parent = 0); View(Containment *containment, int viewId, QWidget *parent = 0);
@ -84,8 +84,8 @@ public:
* Sets which screen this view is associated with, if any. * Sets which screen this view is associated with, if any.
* This will also set the containment if a valid screen is specified * This will also set the containment if a valid screen is specified
* *
* @arg screen the physical screen number; -1 for no screen * @param screen the physical screen number; -1 for no screen
* @arg desktop the virtual desktop number, or -1 for all virtual desktops * @param desktop the virtual desktop number, or -1 for all virtual desktops
*/ */
void setScreen(int screen, int desktop = -1); void setScreen(int screen, int desktop = -1);
@ -140,7 +140,7 @@ public:
/** /**
* Set whether or not the view should adjust its size when the associated * Set whether or not the view should adjust its size when the associated
* containment does. * containment does.
* @arg trackChanges true to synchronize the view's size with the containment's * @param trackChanges true to synchronize the view's size with the containment's
* (this is the default behaviour), false to ignore containment size changes * (this is the default behaviour), false to ignore containment size changes
*/ */
void setTrackContainmentChanges(bool trackChanges); void setTrackContainmentChanges(bool trackChanges);
@ -189,7 +189,7 @@ public Q_SLOTS:
* Sets the containment for this view, which will also cause the view * Sets the containment for this view, which will also cause the view
* to track the geometry of the containment. * to track the geometry of the containment.
* *
* @arg containment the containment to center the view on * @param containment the containment to center the view on
*/ */
virtual void setContainment(Plasma::Containment *containment); virtual void setContainment(Plasma::Containment *containment);

12
wallpaper.h
View File

@ -97,15 +97,15 @@ class PLASMA_EXPORT Wallpaper : public QObject
/** /**
* Returns a list of all known wallpapers. * Returns a list of all known wallpapers.
* *
* @arg formFactor the format of the wallpaper being search for (e.g. desktop) * @param formFactor the format of the wallpaper being search for (e.g. desktop)
* @return list of wallpapers * @return list of wallpapers
**/ **/
static KPluginInfo::List listWallpaperInfo(const QString &formFactor = QString()); static KPluginInfo::List listWallpaperInfo(const QString &formFactor = QString());
/** /**
* Returns a list of all known wallpapers that can accept the given mimetype * Returns a list of all known wallpapers that can accept the given mimetype
* @arg mimetype the mimetype to search for * @param mimetype the mimetype to search for
* @arg formFactor the format of the wallpaper being search for (e.g. desktop) * @param formFactor the format of the wallpaper being search for (e.g. desktop)
* @return list of wallpapers * @return list of wallpapers
*/ */
static KPluginInfo::List listWallpaperInfoForMimetype(const QString &mimetype, static KPluginInfo::List listWallpaperInfoForMimetype(const QString &mimetype,
@ -325,7 +325,7 @@ class PLASMA_EXPORT Wallpaper : public QObject
* Wallpaper's current state, allowing for better selection of papers from packages, * Wallpaper's current state, allowing for better selection of papers from packages,
* for instance. * for instance.
* *
* @arg resizeMethod The resize method to assume will be used for future wallpaper * @param resizeMethod The resize method to assume will be used for future wallpaper
* scaling; may later be changed by calls to render() * scaling; may later be changed by calls to render()
* *
* @since 4.3 * @since 4.3
@ -337,7 +337,7 @@ class PLASMA_EXPORT Wallpaper : public QObject
* Wallpaper's current state, allowing for better selection of papers from packages, * Wallpaper's current state, allowing for better selection of papers from packages,
* for instance. * for instance.
* *
* @arg targetSize The size to assume will be used for future wallpaper scaling * @param targetSize The size to assume will be used for future wallpaper scaling
* *
* @since 4.3 * @since 4.3
*/ */
@ -402,7 +402,7 @@ class PLASMA_EXPORT Wallpaper : public QObject
/** /**
* Emitted when a URL matching X-Plasma-DropMimeTypes is dropped on the wallpaper * Emitted when a URL matching X-Plasma-DropMimeTypes is dropped on the wallpaper
* *
* @arg url the URL of the dropped file * @param url the URL of the dropped file
* @since 4.4 * @since 4.4
*/ */
KDE_DEPRECATED void urlDropped(const KUrl &url); KDE_DEPRECATED void urlDropped(const KUrl &url);

2
widgets/busywidget.h
View File

@ -48,7 +48,7 @@ public:
/** /**
* Constructs a new BusyWidget * Constructs a new BusyWidget
* *
* @arg parent the parent of this widget * @param parent the parent of this widget
*/ */
explicit BusyWidget(QGraphicsWidget *parent = 0); explicit BusyWidget(QGraphicsWidget *parent = 0);
~BusyWidget(); ~BusyWidget();

8
widgets/checkbox.h
View File

@ -54,7 +54,7 @@ public:
/** /**
* Sets the display text for this CheckBox * Sets the display text for this CheckBox
* *
* @arg text the text to display; should be translated. * @param text the text to display; should be translated.
*/ */
void setText(const QString &text); void setText(const QString &text);
@ -66,7 +66,7 @@ public:
/** /**
* Sets the path to an image to display. * Sets the path to an image to display.
* *
* @arg path the path to the image; if a relative path, then a themed image will be loaded. * @param path the path to the image; if a relative path, then a themed image will be loaded.
*/ */
void setImage(const QString &path); void setImage(const QString &path);
@ -78,7 +78,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this CheckBox * Sets the stylesheet used to control the visual display of this CheckBox
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);
@ -95,7 +95,7 @@ public:
/** /**
* Sets the checked state. * Sets the checked state.
* *
* @arg checked true if checked, false if not * @param checked true if checked, false if not
*/ */
void setChecked(bool checked); void setChecked(bool checked);

4
widgets/combobox.h
View File

@ -59,7 +59,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this ComboBox * Sets the stylesheet used to control the visual display of this ComboBox
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);
@ -71,7 +71,7 @@ public:
/** /**
* Sets the combo box wrapped by this ComboBox (widget must inherit KComboBox), ownership is transferred to the ComboBox * Sets the combo box wrapped by this ComboBox (widget must inherit KComboBox), ownership is transferred to the ComboBox
* *
* @arg combo box that will be wrapped by this ComboBox * @param nativeWidget combo box that will be wrapped by this ComboBox
* @since KDE4.4 * @since KDE4.4
*/ */
void setNativeWidget(KComboBox *nativeWidget); void setNativeWidget(KComboBox *nativeWidget);

12
widgets/frame.h
View File

@ -59,7 +59,7 @@ public:
/** /**
* Constructs a new Frame * Constructs a new Frame
* *
* @arg parent the parent of this widget * @param parent the parent of this widget
*/ */
explicit Frame(QGraphicsWidget *parent = 0); explicit Frame(QGraphicsWidget *parent = 0);
~Frame(); ~Frame();
@ -67,7 +67,7 @@ public:
/** /**
* Sets the Frame's shadow style * Sets the Frame's shadow style
* *
* @arg shadow plain, raised or sunken * @param shadow plain, raised or sunken
*/ */
void setFrameShadow(Shadow shadow); void setFrameShadow(Shadow shadow);
@ -78,7 +78,7 @@ public:
/** /**
* Sets what borders should be painted * Sets what borders should be painted
* @arg flags borders we want to paint * @param flags borders we want to paint
*/ */
void setEnabledBorders(const FrameSvg::EnabledBorders borders); void setEnabledBorders(const FrameSvg::EnabledBorders borders);
@ -92,7 +92,7 @@ public:
/** /**
* Set the text to display by this Frame * Set the text to display by this Frame
* *
* @arg text the text * @param text the text
* @since 4.4 * @since 4.4
*/ */
void setText(QString text); void setText(QString text);
@ -105,7 +105,7 @@ public:
/** /**
* Sets the path to an image to display. * Sets the path to an image to display.
* *
* @arg path the path to the image; if a relative path, then a themed image will be loaded. * @param path the path to the image; if a relative path, then a themed image will be loaded.
*/ */
void setImage(const QString &path); void setImage(const QString &path);
@ -117,7 +117,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this Frame * Sets the stylesheet used to control the visual display of this Frame
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);

4
widgets/groupbox.h
View File

@ -52,7 +52,7 @@ public:
/** /**
* Sets the display text for this GroupBox * Sets the display text for this GroupBox
* *
* @arg text the text to display; should be translated. * @param text the text to display; should be translated.
*/ */
void setText(const QString &text); void setText(const QString &text);
@ -64,7 +64,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this GroupBox * Sets the stylesheet used to control the visual display of this GroupBox
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);

2
widgets/iconwidget.h
View File

@ -297,7 +297,7 @@ public:
/** /**
* Sets whether or not to draw a background area for the icon * Sets whether or not to draw a background area for the icon
* *
* @arg draw true if a background should be drawn or not * @param draw true if a background should be drawn or not
*/ */
void setDrawBackground(bool draw); void setDrawBackground(bool draw);

2
widgets/itembackground.h
View File

@ -52,7 +52,7 @@ public:
/** /**
* Sets a new target geometry we want at the end of animation * Sets a new target geometry we want at the end of animation
* *
* @arg newGeometry the final geometry target * @param newGeometry the final geometry target
*/ */
void setTarget(const QRectF &newGeometry); void setTarget(const QRectF &newGeometry);

16
widgets/label.h
View File

@ -55,7 +55,7 @@ public:
/** /**
* Constructs a label with word wrap on by default * Constructs a label with word wrap on by default
* *
* @arg parent the parent of this widget * @param parent the parent of this widget
*/ */
explicit Label(QGraphicsWidget *parent = 0); explicit Label(QGraphicsWidget *parent = 0);
~Label(); ~Label();
@ -63,7 +63,7 @@ public:
/** /**
* Sets the display text for this Label * Sets the display text for this Label
* *
* @arg text the text to display; should be translated. * @param text the text to display; should be translated.
*/ */
void setText(const QString &text); void setText(const QString &text);
@ -75,7 +75,7 @@ public:
/** /**
* Sets the path to an image to display. * Sets the path to an image to display.
* *
* @arg path the path to the image; if a relative path, then a themed image will be loaded. * @param path the path to the image; if a relative path, then a themed image will be loaded.
*/ */
void setImage(const QString &path); void setImage(const QString &path);
@ -87,7 +87,7 @@ public:
/** /**
* Sets the alignment for the text * Sets the alignment for the text
* *
* @arg the desired alignment * @param the desired alignment
*/ */
void setAlignment(Qt::Alignment alignment); void setAlignment(Qt::Alignment alignment);
@ -99,7 +99,7 @@ public:
/** /**
* Scale or not the contents of the label to the label size * Scale or not the contents of the label to the label size
* *
* @arg scale * @param scale
*/ */
void setScaledContents(bool scaled); void setScaledContents(bool scaled);
@ -111,7 +111,7 @@ public:
/** /**
* Set if the text on the label can be selected with the mouse * Set if the text on the label can be selected with the mouse
* *
* @arg enable true if we want to manage text selection with the mouse * @param enable true if we want to manage text selection with the mouse
* @since 4.4 * @since 4.4
*/ */
void setTextSelectable(bool enable); void setTextSelectable(bool enable);
@ -125,7 +125,7 @@ public:
/** /**
* Sets if the text of the label can wrap in multiple lines * Sets if the text of the label can wrap in multiple lines
* *
* @arg wrap multiple lines or not * @param wrap multiple lines or not
* @since 4.5 * @since 4.5
*/ */
void setWordWrap(bool wrap); void setWordWrap(bool wrap);
@ -139,7 +139,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this Label * Sets the stylesheet used to control the visual display of this Label
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);

6
widgets/lineedit.h
View File

@ -54,7 +54,7 @@ public:
/** /**
* Sets the display text for this LineEdit * Sets the display text for this LineEdit
* *
* @arg text the text to display; should be translated. * @param text the text to display; should be translated.
*/ */
void setText(const QString &text); void setText(const QString &text);
@ -92,7 +92,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this LineEdit * Sets the stylesheet used to control the visual display of this LineEdit
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);
@ -104,7 +104,7 @@ public:
/** /**
* Sets the line edit wrapped by this LineEdit (widget must inherit KLineEdit), ownership is transferred to the LineEdit * Sets the line edit wrapped by this LineEdit (widget must inherit KLineEdit), ownership is transferred to the LineEdit
* *
* @arg text edit that will be wrapped by this LineEdit * @param nativeWidget line edit that will be wrapped by this LineEdit
* @since KDE4.4 * @since KDE4.4
*/ */
void setNativeWidget(KLineEdit *nativeWidget); void setNativeWidget(KLineEdit *nativeWidget);

14
widgets/pushbutton.h
View File

@ -60,7 +60,7 @@ public:
/** /**
* Sets the display text for this PushButton * Sets the display text for this PushButton
* *
* @arg text the text to display; should be translated. * @param text the text to display; should be translated.
*/ */
void setText(const QString &text); void setText(const QString &text);
@ -72,15 +72,15 @@ public:
/** /**
* Sets the path to an image to display. * Sets the path to an image to display.
* *
* @arg path the path to the image; if a relative path, then a themed image will be loaded. * @param path the path to the image; if a relative path, then a themed image will be loaded.
*/ */
void setImage(const QString &path); void setImage(const QString &path);
/** /**
* Sets the path to an svg image to display and the id of the used svg element, if necessary. * Sets the path to an svg image to display and the id of the used svg element, if necessary.
* *
* @arg path the path to the image; if a relative path, then a themed image will be loaded. * @param path the path to the image; if a relative path, then a themed image will be loaded.
* @arg elementid the id of a svg element. * @param elementid the id of a svg element.
* *
* @since 4.4 * @since 4.4
*/ */
@ -94,7 +94,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this PushButton * Sets the stylesheet used to control the visual display of this PushButton
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);
@ -122,7 +122,7 @@ public:
/** /**
* sets the icon for this push button * sets the icon for this push button
* *
* @arg icon the icon to use * @param icon the icon to use
* *
* @since 4.3 * @since 4.3
*/ */
@ -131,7 +131,7 @@ public:
/** /**
* sets the icon for this push button using a KIcon * sets the icon for this push button using a KIcon
* *
* @arg icon the icon to use * @param icon the icon to use
* *
* @since 4.4 * @since 4.4
*/ */

8
widgets/radiobutton.h
View File

@ -54,7 +54,7 @@ public:
/** /**
* Sets the display text for this RadioButton * Sets the display text for this RadioButton
* *
* @arg text the text to display; should be translated. * @param text the text to display; should be translated.
*/ */
void setText(const QString &text); void setText(const QString &text);
@ -66,7 +66,7 @@ public:
/** /**
* Sets the path to an image to display. * Sets the path to an image to display.
* *
* @arg path the path to the image; if a relative path, then a themed image will be loaded. * @param path the path to the image; if a relative path, then a themed image will be loaded.
*/ */
void setImage(const QString &path); void setImage(const QString &path);
@ -78,7 +78,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this RadioButton * Sets the stylesheet used to control the visual display of this RadioButton
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);
@ -95,7 +95,7 @@ public:
/** /**
* Sets the checked state. * Sets the checked state.
* *
* @arg checked true if checked, false if not * @param checked true if checked, false if not
*/ */
void setChecked(bool checked); void setChecked(bool checked);

16
widgets/scrollbar.h
View File

@ -59,15 +59,15 @@ public:
/** /**
* Sets the scrollbar minimum and maximum values * Sets the scrollbar minimum and maximum values
* @arg min minimum value * @param min minimum value
* @arg max maximum value * @param max maximum value
*/ */
void setRange(int min, int max); void setRange(int min, int max);
/** /**
* Sets the amount of the single step * Sets the amount of the single step
* i.e how much the slider will move when the user press an arrow button * i.e how much the slider will move when the user press an arrow button
* @arg val * @param val
*/ */
void setSingleStep(int val); void setSingleStep(int val);
@ -78,7 +78,7 @@ public:
/** /**
* Sets the amount the slider will scroll when the user press page up or page down * Sets the amount the slider will scroll when the user press page up or page down
* @arg val * @param val
*/ */
void setPageStep(int val); void setPageStep(int val);
@ -103,13 +103,13 @@ public:
int maximum() const; int maximum() const;
/** /**
* @arg the minimum value bound of this ScrollBar * @param the minimum value bound of this ScrollBar
* @since 4.6 * @since 4.6
*/ */
void setMinimum(const int min) const; void setMinimum(const int min) const;
/** /**
* @arg the maximum value bound of this ScrollBar * @param the maximum value bound of this ScrollBar
* @since 4.6 * @since 4.6
*/ */
void setMaximum(const int max) const; void setMaximum(const int max) const;
@ -117,7 +117,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this ScrollBar * Sets the stylesheet used to control the visual display of this ScrollBar
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);
@ -143,7 +143,7 @@ protected:
public Q_SLOTS: public Q_SLOTS:
/** /**
* Sets the current value for the ScrollBar * Sets the current value for the ScrollBar
* @arg value must be minimum() <= value <= maximum() * @param value must be minimum() <= value <= maximum()
*/ */
void setValue(int val); void setValue(int val);

12
widgets/scrollwidget.h
View File

@ -60,7 +60,7 @@ public:
/** /**
* Constructs a new ScrollWidget * Constructs a new ScrollWidget
* *
* @arg parent the parent of this widget * @param parent the parent of this widget
*/ */
explicit ScrollWidget(QGraphicsWidget *parent = 0); explicit ScrollWidget(QGraphicsWidget *parent = 0);
explicit ScrollWidget(QGraphicsItem *parent); explicit ScrollWidget(QGraphicsItem *parent);
@ -74,7 +74,7 @@ public:
* it will be resized when possible, otherwise it will be kept to whichever * it will be resized when possible, otherwise it will be kept to whichever
* width the widget resizes itself. * width the widget resizes itself.
* *
* @arg widget the new main sub widget * @param widget the new main sub widget
*/ */
void setWidget(QGraphicsWidget *widget); void setWidget(QGraphicsWidget *widget);
@ -114,7 +114,7 @@ public:
/** /**
* Sets the horizontal scrollbar policy * Sets the horizontal scrollbar policy
* *
* @arg policy desired policy * @param policy desired policy
*/ */
void setHorizontalScrollBarPolicy(const Qt::ScrollBarPolicy policy); void setHorizontalScrollBarPolicy(const Qt::ScrollBarPolicy policy);
@ -126,7 +126,7 @@ public:
/** /**
* Sets the vertical scrollbar policy * Sets the vertical scrollbar policy
* *
* @arg policy desired policy * @param policy desired policy
*/ */
void setVerticalScrollBarPolicy(const Qt::ScrollBarPolicy policy); void setVerticalScrollBarPolicy(const Qt::ScrollBarPolicy policy);
@ -226,7 +226,7 @@ public:
* Set the nap size of the kinetic scrolling: * Set the nap size of the kinetic scrolling:
* the scrolling will always stop at multiples of that size. * the scrolling will always stop at multiples of that size.
* *
* @arg the desired snap size * @param the desired snap size
* @since 4.5 * @since 4.5
*/ */
void setSnapSize(const QSizeF &size); void setSnapSize(const QSizeF &size);
@ -240,7 +240,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this ScrollWidget * Sets the stylesheet used to control the visual display of this ScrollWidget
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);

2
widgets/slider.h
View File

@ -75,7 +75,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this Slider * Sets the stylesheet used to control the visual display of this Slider
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);

2
widgets/spinbox.h
View File

@ -70,7 +70,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this SpinBox * Sets the stylesheet used to control the visual display of this SpinBox
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);

52
widgets/tabbar.h
View File

@ -59,7 +59,7 @@ public:
/** /**
* Constructs a new TabBar * Constructs a new TabBar
* *
* @arg parent the parent of this widget * @param parent the parent of this widget
*/ */
explicit TabBar(QGraphicsWidget *parent = 0); explicit TabBar(QGraphicsWidget *parent = 0);
~TabBar(); ~TabBar();
@ -67,12 +67,12 @@ public:
/** /**
* Adds a new tab in the desired position * Adds a new tab in the desired position
* *
* @arg index the position where to insert the new tab, * @param index the position where to insert the new tab,
* if index <=0 will be the first position, * if index <=0 will be the first position,
* if index >= count() will be the last * if index >= count() will be the last
* @arg icon the icon for this tab * @param icon the icon for this tab
* @arg label the text label of the tab * @param label the text label of the tab
* @arg content the page content that will be shown by this tab * @param content the page content that will be shown by this tab
* @return the index of the inserted tab * @return the index of the inserted tab
*/ */
Q_INVOKABLE int insertTab(int index, const QIcon &icon, const QString &label, Q_INVOKABLE int insertTab(int index, const QIcon &icon, const QString &label,
@ -83,11 +83,11 @@ public:
* This is an overloaded member provided for convenience * This is an overloaded member provided for convenience
* equivalent to insertTab(index, QIcon(), label); * equivalent to insertTab(index, QIcon(), label);
* *
* @arg index the position where to insert the new tab, * @param index the position where to insert the new tab,
* if index <=0 will be the first position, * if index <=0 will be the first position,
* if index >= count() will be the last * if index >= count() will be the last
* @arg label the text label of the tab * @param label the text label of the tab
* @arg content the page content that will be shown by this tab * @param content the page content that will be shown by this tab
* @return the index of the inserted tab * @return the index of the inserted tab
*/ */
Q_INVOKABLE int insertTab(int index, const QString &label, QGraphicsLayoutItem *content = 0); Q_INVOKABLE int insertTab(int index, const QString &label, QGraphicsLayoutItem *content = 0);
@ -95,9 +95,9 @@ public:
/** /**
* Adds a new tab in the last position * Adds a new tab in the last position
* *
* @arg icon the icon for this tab * @param icon the icon for this tab
* @arg label the text label of the tab * @param label the text label of the tab
* @arg content the page content that will be shown by this tab * @param content the page content that will be shown by this tab
* @return the index of the inserted tab * @return the index of the inserted tab
*/ */
Q_INVOKABLE int addTab(const QIcon &icon, const QString &label, QGraphicsLayoutItem *content = 0); Q_INVOKABLE int addTab(const QIcon &icon, const QString &label, QGraphicsLayoutItem *content = 0);
@ -107,8 +107,8 @@ public:
* This is an overloaded member provided for convenience * This is an overloaded member provided for convenience
* equivalent to addTab(QIcon(), label, page) * equivalent to addTab(QIcon(), label, page)
* *
* @arg label the text label of the tab * @param label the text label of the tab
* @arg content the page content that will be shown by this tab * @param content the page content that will be shown by this tab
* @return the index of the inserted tab * @return the index of the inserted tab
*/ */
Q_INVOKABLE int addTab(const QString &label, QGraphicsLayoutItem *content = 0); Q_INVOKABLE int addTab(const QString &label, QGraphicsLayoutItem *content = 0);
@ -116,14 +116,14 @@ public:
/** /**
* Removes a tab, contents are deleted * Removes a tab, contents are deleted
* *
* @arg index the index of the tab to remove * @param index the index of the tab to remove
*/ */
Q_INVOKABLE void removeTab(int index); Q_INVOKABLE void removeTab(int index);
/** /**
* Removes a tab, the page is reparented to 0 and is returned * Removes a tab, the page is reparented to 0 and is returned
* *
* @arg index the index of the tab to remove * @param index the index of the tab to remove
* @since 4.4 * @since 4.4
*/ */
Q_INVOKABLE QGraphicsLayoutItem *takeTab(int index); Q_INVOKABLE QGraphicsLayoutItem *takeTab(int index);
@ -131,7 +131,7 @@ public:
/** /**
* Returns the contents of a page * Returns the contents of a page
* *
* @arg index the index of the tab to retrieve * @param index the index of the tab to retrieve
* @since 4.4 * @since 4.4
*/ */
Q_INVOKABLE QGraphicsLayoutItem *tabAt(int index); Q_INVOKABLE QGraphicsLayoutItem *tabAt(int index);
@ -149,30 +149,30 @@ public:
/** /**
* Sets the text label of the given tab * Sets the text label of the given tab
* *
* @arg index the index of the tab to modify * @param index the index of the tab to modify
* @arg label the new text label of the given tab * @param label the new text label of the given tab
*/ */
Q_INVOKABLE void setTabText(int index, const QString &label); Q_INVOKABLE void setTabText(int index, const QString &label);
/** /**
* @return the text label of the given tab * @return the text label of the given tab
* *
* @arg index the index of the tab we want to know its label * @param index the index of the tab we want to know its label
*/ */
Q_INVOKABLE QString tabText(int index) const; Q_INVOKABLE QString tabText(int index) const;
/** /**
* Sets an icon for a given tab * Sets an icon for a given tab
* *
* @arg index the index of the tab to modify * @param index the index of the tab to modify
* @arg icon the new icon for the given tab * @param icon the new icon for the given tab
*/ */
Q_INVOKABLE void setTabIcon(int index, const QIcon &icon); Q_INVOKABLE void setTabIcon(int index, const QIcon &icon);
/** /**
* @return the current icon for a given tab * @return the current icon for a given tab
* *
* @arg index the index of the tab we want to know its icon * @param index the index of the tab we want to know its icon
*/ */
Q_INVOKABLE QIcon tabIcon(int index) const; Q_INVOKABLE QIcon tabIcon(int index) const;
@ -181,7 +181,7 @@ public:
* pages, when the tabbar doesn't have content pages at all this * pages, when the tabbar doesn't have content pages at all this
* function has no effect * function has no effect
* *
* @arg show true if we want to show the tabbar * @param show true if we want to show the tabbar
* @since 4.3 * @since 4.3
*/ */
void setTabBarShown(bool show); void setTabBarShown(bool show);
@ -195,7 +195,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this TabBar * Sets the stylesheet used to control the visual display of this TabBar
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);
@ -257,7 +257,7 @@ public Q_SLOTS:
/** /**
* Activate a given tab * Activate a given tab
* *
* @arg index the index of the tab to activate * @param index the index of the tab to activate
*/ */
void setCurrentIndex(int index); void setCurrentIndex(int index);
@ -265,7 +265,7 @@ Q_SIGNALS:
/** /**
* Emitted when the active tab changes * Emitted when the active tab changes
* *
* @arg index the newly activated tab * @param index the newly activated tab
*/ */
void currentChanged(int index); void currentChanged(int index);

4
widgets/textbrowser.h
View File

@ -55,7 +55,7 @@ public:
/** /**
* Sets the display text for this TextBrowser * Sets the display text for this TextBrowser
* *
* @arg text the text to display; should be translated. * @param text the text to display; should be translated.
*/ */
void setText(const QString &text); void setText(const QString &text);
@ -77,7 +77,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this TextBrowser * Sets the stylesheet used to control the visual display of this TextBrowser
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);

8
widgets/textedit.h
View File

@ -54,7 +54,7 @@ public:
/** /**
* Sets the display text for this TextEdit * Sets the display text for this TextEdit
* *
* @arg text the text to display; should be translated. * @param text the text to display; should be translated.
*/ */
void setText(const QString &text); void setText(const QString &text);
@ -65,7 +65,7 @@ public:
/** /**
* Sets the text area to be read only or interactive * Sets the text area to be read only or interactive
* @arg true to make it read only, false for interactive * @param true to make it read only, false for interactive
* @since 4.4 * @since 4.4
*/ */
void setReadOnly(bool readOnly); void setReadOnly(bool readOnly);
@ -78,7 +78,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this TextEdit * Sets the stylesheet used to control the visual display of this TextEdit
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);
@ -90,7 +90,7 @@ public:
/** /**
* Sets the text edit wrapped by this TextEdit (widget must inherit KTextEdit), ownership is transferred to the TextEdit * Sets the text edit wrapped by this TextEdit (widget must inherit KTextEdit), ownership is transferred to the TextEdit
* *
* @arg text edit that will be wrapped by this TextEdit * @param nativeWidget text edit that will be wrapped by this TextEdit
* @since KDE4.4 * @since KDE4.4
*/ */
void setNativeWidget(KTextEdit *nativeWidget); void setNativeWidget(KTextEdit *nativeWidget);

16
widgets/toolbutton.h
View File

@ -58,7 +58,7 @@ public:
/** /**
* Sets if the toolbutton has an autoraise behaviour * Sets if the toolbutton has an autoraise behaviour
* *
* @arg raise * @param raise
*/ */
void setAutoRaise(bool raise); void setAutoRaise(bool raise);
@ -70,7 +70,7 @@ public:
/** /**
* Sets the display text for this ToolButton * Sets the display text for this ToolButton
* *
* @arg text the text to display; should be translated. * @param text the text to display; should be translated.
*/ */
void setText(const QString &text); void setText(const QString &text);
@ -82,15 +82,15 @@ public:
/** /**
* Sets the path to an image to display. * Sets the path to an image to display.
* *
* @arg path the path to the image; if a relative path, then a themed image will be loaded. * @param path the path to the image; if a relative path, then a themed image will be loaded.
*/ */
void setImage(const QString &path); void setImage(const QString &path);
/** /**
* Sets the path to an svg image to display and the id of the used svg element, if necessary. * Sets the path to an svg image to display and the id of the used svg element, if necessary.
* *
* @arg path the path to the image; if a relative path, then a themed image will be loaded. * @param path the path to the image; if a relative path, then a themed image will be loaded.
* @arg elementid the id of a svg element. * @param elementid the id of a svg element.
* *
* @since 4.4 * @since 4.4
*/ */
@ -104,7 +104,7 @@ public:
/** /**
* Sets the status of the button to pressed * Sets the status of the button to pressed
* *
* @arg down * @param down
* @since 4.5 * @since 4.5
*/ */
void setDown(bool down); void setDown(bool down);
@ -118,7 +118,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this ToolButton * Sets the stylesheet used to control the visual display of this ToolButton
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);
@ -146,7 +146,7 @@ public:
/** /**
* sets the icon for this toolbutton * sets the icon for this toolbutton
* *
* @arg icon the icon we want to use * @param icon the icon we want to use
* *
* @since 4.3 * @since 4.3
*/ */

4
widgets/treeview.h
View File

@ -53,7 +53,7 @@ public:
/** /**
* Sets a model for this weather view * Sets a model for this weather view
* *
* @arg model the model to display * @param model the model to display
*/ */
void setModel(QAbstractItemModel *model); void setModel(QAbstractItemModel *model);
@ -65,7 +65,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this TreeView * Sets the stylesheet used to control the visual display of this TreeView
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);

12
widgets/videowidget.h
View File

@ -79,7 +79,7 @@ public:
/** /**
* Load a certain url that can be a local file or a remote one * Load a certain url that can be a local file or a remote one
* @arg path resource to play * @param path resource to play
*/ */
void setUrl(const QString &url); void setUrl(const QString &url);
@ -118,7 +118,7 @@ public:
/** /**
* Set what control widgets to use * Set what control widgets to use
* *
* @arg controls bitwise OR combination of Controls flags * @param controls bitwise OR combination of Controls flags
* @see Controls * @see Controls
*/ */
void setUsedControls(const Controls controls); void setUsedControls(const Controls controls);
@ -132,7 +132,7 @@ public:
/** /**
* Show/hide the main controls widget, if any of them is used * Show/hide the main controls widget, if any of them is used
* *
* @arg visible if we want to show or hide the main controls * @param visible if we want to show or hide the main controls
* @see setUsedControls() * @see setUsedControls()
*/ */
void setControlsVisible(bool visible); void setControlsVisible(bool visible);
@ -145,7 +145,7 @@ public:
/** /**
* Sets the stylesheet used to control the visual display of this VideoWidget * Sets the stylesheet used to control the visual display of this VideoWidget
* *
* @arg stylesheet a CSS string * @param stylesheet a CSS string
*/ */
void setStyleSheet(const QString &stylesheet); void setStyleSheet(const QString &stylesheet);
@ -178,14 +178,14 @@ public Q_SLOTS:
/** /**
* Jump at a given millisecond in the current file * Jump at a given millisecond in the current file
* @arg time where we want to jump * @param time where we want to jump
*/ */
void seek(qint64 time); void seek(qint64 time);
Q_SIGNALS: Q_SIGNALS:
/** /**
* Emitted regularly when the playing is progressing * Emitted regularly when the playing is progressing
* @arg time where we are * @param time where we are
*/ */
void tick(qint64 time); void tick(qint64 time);

10
windoweffects.h
View File

@ -57,10 +57,10 @@ namespace WindowEffects
/** /**
* Mark a window as sliding from screen edge * Mark a window as sliding from screen edge
* *
* @arg id of the window on which we want to apply the effect * @param id of the window on which we want to apply the effect
* @arg location edge of the screen from which we want the sliding effect. * @param location edge of the screen from which we want the sliding effect.
* Desktop and Floating won't have effect. * Desktop and Floating won't have effect.
* @arg offset distance in pixels from the screen edge defined by location * @param offset distance in pixels from the screen edge defined by location
* @since 4.4 * @since 4.4
*/ */
PLASMA_EXPORT void slideWindow(WId id, Plasma::Location location, int offset); PLASMA_EXPORT void slideWindow(WId id, Plasma::Location location, int offset);
@ -69,8 +69,8 @@ namespace WindowEffects
* Mark a window as sliding from screen edge * Mark a window as sliding from screen edge
* This is an overloaded member function provided for convenience * This is an overloaded member function provided for convenience
* *
* @arg widget QWidget corresponding to the top level window we want to animate * @param widget QWidget corresponding to the top level window we want to animate
* @arg location edge of the screen from which we want the sliding effect. * @param location edge of the screen from which we want the sliding effect.
* Desktop and Floating won't have effect. * Desktop and Floating won't have effect.
* @since 4.4 * @since 4.4
*/ */