Fix minor EBN issues in the Doxygen code
This commit is contained in:
parent
2a1a0e4280
commit
6f982e88a0
4 changed files with 21 additions and 21 deletions
|
@ -188,7 +188,7 @@ protected:
|
||||||
* @p defaultValue determines whether the Effect should be loaded. A value of @c true means
|
* @p defaultValue determines whether the Effect should be loaded. A value of @c true means
|
||||||
* that Load | CheckDefaultFunction is returned, in case of @c false no Load flags are returned.
|
* that Load | CheckDefaultFunction is returned, in case of @c false no Load flags are returned.
|
||||||
*
|
*
|
||||||
* @param effecName The name of the Effect to look for in the configuration
|
* @param effectName The name of the Effect to look for in the configuration
|
||||||
* @param defaultValue Whether the Effect is enabled by default or not.
|
* @param defaultValue Whether the Effect is enabled by default or not.
|
||||||
* @returns Flags indicating whether the Effect should be loaded and how it should be loaded
|
* @returns Flags indicating whether the Effect should be loaded and how it should be loaded
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -65,7 +65,7 @@ public:
|
||||||
*
|
*
|
||||||
* @param action The action to trigger if the shortcut is triggered
|
* @param action The action to trigger if the shortcut is triggered
|
||||||
* @param modifiers The modifiers which need to be hold to trigger the action
|
* @param modifiers The modifiers which need to be hold to trigger the action
|
||||||
* @param pointerButtons The pointer axis
|
* @param axis The pointer axis
|
||||||
*/
|
*/
|
||||||
void registerAxisShortcut(QAction *action, Qt::KeyboardModifiers modifiers, PointerAxisDirection axis);
|
void registerAxisShortcut(QAction *action, Qt::KeyboardModifiers modifiers, PointerAxisDirection axis);
|
||||||
|
|
||||||
|
|
36
screenedge.h
36
screenedge.h
|
@ -162,40 +162,40 @@ private:
|
||||||
*
|
*
|
||||||
* The screen edge functionality is split into three parts:
|
* The screen edge functionality is split into three parts:
|
||||||
* @li This manager class ScreenEdges
|
* @li This manager class ScreenEdges
|
||||||
* @li abstract class @link Edge
|
* @li abstract class @ref Edge
|
||||||
* @li specific implementation of @link Edge, e.g. @link WindowBasedEdge
|
* @li specific implementation of @ref Edge, e.g. @ref WindowBasedEdge
|
||||||
*
|
*
|
||||||
* The ScreenEdges creates an @link Edge for each screen edge which is also an edge in the
|
* The ScreenEdges creates an @ref Edge for each screen edge which is also an edge in the
|
||||||
* combination of all screens. E.g. if there are two screens, no Edge is created between the screens,
|
* combination of all screens. E.g. if there are two screens, no Edge is created between the screens,
|
||||||
* but at all other edges even if the screens have a different dimension.
|
* but at all other edges even if the screens have a different dimension.
|
||||||
*
|
*
|
||||||
* In addition at each corner of the overall display geometry an one-pixel large @link Edge is
|
* In addition at each corner of the overall display geometry an one-pixel large @ref Edge is
|
||||||
* created. No matter how many screens there are, there will only be exactly four of these corner
|
* created. No matter how many screens there are, there will only be exactly four of these corner
|
||||||
* edges. This is motivated by Fitts's Law which show that it's easy to trigger such a corner, but
|
* edges. This is motivated by Fitts's Law which show that it's easy to trigger such a corner, but
|
||||||
* it would be very difficult to trigger a corner between two screens (one pixel target not visually
|
* it would be very difficult to trigger a corner between two screens (one pixel target not visually
|
||||||
* outlined).
|
* outlined).
|
||||||
*
|
*
|
||||||
* The ScreenEdges are used for one of the following functionality:
|
* The ScreenEdges are used for one of the following functionality:
|
||||||
* @li switch virtual desktop (see property @link desktopSwitching)
|
* @li switch virtual desktop (see property @ref desktopSwitching)
|
||||||
* @li switch virtual desktop when moving a window (see property @link desktopSwitchingMovingClients)
|
* @li switch virtual desktop when moving a window (see property @ref desktopSwitchingMovingClients)
|
||||||
* @li trigger a pre-defined action (see properties @link actionTop and similar)
|
* @li trigger a pre-defined action (see properties @ref actionTop and similar)
|
||||||
* @li trigger an externally configured action (e.g. Effect, Script, see @link reserve, @link unreserve)
|
* @li trigger an externally configured action (e.g. Effect, Script, see @ref reserve, @ref unreserve)
|
||||||
*
|
*
|
||||||
* An @link Edge is only active if there is at least one of the possible actions "reserved" for this
|
* An @ref Edge is only active if there is at least one of the possible actions "reserved" for this
|
||||||
* edge. The idea is to not block the screen edge if nothing could be triggered there, so that the
|
* edge. The idea is to not block the screen edge if nothing could be triggered there, so that the
|
||||||
* user e.g. can configure nothing on the top edge, which tends to interfere with full screen apps
|
* user e.g. can configure nothing on the top edge, which tends to interfere with full screen apps
|
||||||
* having a hidden panel there. On X11 (currently only supported backend) the @link Edge is
|
* having a hidden panel there. On X11 (currently only supported backend) the @ref Edge is
|
||||||
* represented by a @link WindowBasedEdge which creates an input only window for the geometry and
|
* represented by a @ref WindowBasedEdge which creates an input only window for the geometry and
|
||||||
* reacts on enter notify events. If the edge gets reserved for the first time a window is created
|
* reacts on enter notify events. If the edge gets reserved for the first time a window is created
|
||||||
* and mapped, once the edge gets unreserved again, the window gets destroyed.
|
* and mapped, once the edge gets unreserved again, the window gets destroyed.
|
||||||
*
|
*
|
||||||
* When the mouse enters one of the screen edges the following values are used to determine whether
|
* When the mouse enters one of the screen edges the following values are used to determine whether
|
||||||
* the action should be triggered or the cursor be pushed back
|
* the action should be triggered or the cursor be pushed back
|
||||||
* @li Time difference between two entering events is not larger than a certain threshold
|
* @li Time difference between two entering events is not larger than a certain threshold
|
||||||
* @li Time difference between two entering events is larger than @link timeThreshold
|
* @li Time difference between two entering events is larger than @ref timeThreshold
|
||||||
* @li Time difference between two activations is larger than @link reActivateThreshold
|
* @li Time difference between two activations is larger than @ref reActivateThreshold
|
||||||
* @li Distance between two enter events is not larger than a defined pixel distance
|
* @li Distance between two enter events is not larger than a defined pixel distance
|
||||||
* These checks are performed in @link Edge
|
* These checks are performed in @ref Edge
|
||||||
*
|
*
|
||||||
* @todo change way how Effects/Scripts can reserve an edge and are notified.
|
* @todo change way how Effects/Scripts can reserve an edge and are notified.
|
||||||
*/
|
*/
|
||||||
|
@ -241,7 +241,7 @@ public:
|
||||||
/**
|
/**
|
||||||
* Mark the specified screen edge as reserved. This method is provided for external activation
|
* Mark the specified screen edge as reserved. This method is provided for external activation
|
||||||
* like effects and scripts. When the effect/script does no longer need the edge it is supposed
|
* like effects and scripts. When the effect/script does no longer need the edge it is supposed
|
||||||
* to call @link unreserve.
|
* to call @ref unreserve.
|
||||||
* @param border the screen edge to mark as reserved
|
* @param border the screen edge to mark as reserved
|
||||||
* @param object The object on which the @p callback needs to be invoked
|
* @param object The object on which the @p callback needs to be invoked
|
||||||
* @param callback The method name to be invoked - uses QMetaObject::invokeMethod
|
* @param callback The method name to be invoked - uses QMetaObject::invokeMethod
|
||||||
|
@ -251,7 +251,7 @@ public:
|
||||||
void reserve(ElectricBorder border, QObject *object, const char *callback);
|
void reserve(ElectricBorder border, QObject *object, const char *callback);
|
||||||
/**
|
/**
|
||||||
* Mark the specified screen edge as unreserved. This method is provided for external activation
|
* Mark the specified screen edge as unreserved. This method is provided for external activation
|
||||||
* like effects and scripts. This method is only allowed to be called if @link reserve had been
|
* like effects and scripts. This method is only allowed to be called if @ref reserve had been
|
||||||
* called before for the same @p border. An unbalanced calling of reserve/unreserve leads to the
|
* called before for the same @p border. An unbalanced calling of reserve/unreserve leads to the
|
||||||
* edge never being active or never being able to deactivate again.
|
* edge never being active or never being able to deactivate again.
|
||||||
* @param border the screen edge to mark as unreserved
|
* @param border the screen edge to mark as unreserved
|
||||||
|
@ -288,7 +288,7 @@ public:
|
||||||
* Mark the specified screen edge as reserved for touch gestures. This method is provided for
|
* Mark the specified screen edge as reserved for touch gestures. This method is provided for
|
||||||
* external activation like effects and scripts.
|
* external activation like effects and scripts.
|
||||||
* When the effect/script does no longer need the edge it is supposed
|
* When the effect/script does no longer need the edge it is supposed
|
||||||
* to call @link unreserveTouch.
|
* to call @ref unreserveTouch.
|
||||||
* @param border the screen edge to mark as reserved
|
* @param border the screen edge to mark as reserved
|
||||||
* @param action The action which gets triggered
|
* @param action The action which gets triggered
|
||||||
* @see unreserveTouch
|
* @see unreserveTouch
|
||||||
|
@ -304,7 +304,7 @@ public:
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Reserve desktop switching for screen edges, if @p isToReserve is @c true. Unreserve otherwise.
|
* Reserve desktop switching for screen edges, if @p isToReserve is @c true. Unreserve otherwise.
|
||||||
* @param reserve indicated weather desktop switching should be reserved or unreseved
|
* @param isToReserve indicated whether desktop switching should be reserved or unreseved
|
||||||
*/
|
*/
|
||||||
void reserveDesktopSwitching(bool isToReserve, Qt::Orientations o);
|
void reserveDesktopSwitching(bool isToReserve, Qt::Orientations o);
|
||||||
/**
|
/**
|
||||||
|
|
|
@ -362,7 +362,7 @@ public Q_SLOTS:
|
||||||
*/
|
*/
|
||||||
void updateLayout();
|
void updateLayout();
|
||||||
/**
|
/**
|
||||||
* @param enable wrapping around borders for navigation in desktop layout
|
* @param enabled wrapping around borders for navigation in desktop layout
|
||||||
* @see isNavigationWrappingAround
|
* @see isNavigationWrappingAround
|
||||||
* @see navigationWrappingAroundChanged
|
* @see navigationWrappingAroundChanged
|
||||||
**/
|
**/
|
||||||
|
|
Loading…
Reference in a new issue