From f5e598039b4ff7f304ddfa82a5b55f2d96509992 Mon Sep 17 00:00:00 2001 From: Kristen McWilliam Date: Thu, 28 Oct 2021 11:12:54 -0400 Subject: [PATCH] dbusinterface: add whitespace to declarations with doc comments Without spacing it is not immediately evident where a doc comment ends and a new declaration begins. Adding a line of whitespace makes everything more readable and easier to scan quickly. --- src/dbusinterface.h | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/src/dbusinterface.h b/src/dbusinterface.h index 52c29a216c..006c9bcb62 100644 --- a/src/dbusinterface.h +++ b/src/dbusinterface.h @@ -84,24 +84,29 @@ class CompositorDBusInterface : public QObject { Q_OBJECT Q_CLASSINFO("D-Bus Interface", "org.kde.kwin.Compositing") + /** * @brief Whether the Compositor is active. That is a Scene is present and the Compositor is * not shutting down itself. */ Q_PROPERTY(bool active READ isActive) + /** * @brief Whether compositing is possible. Mostly means whether the required X extensions * are available. */ Q_PROPERTY(bool compositingPossible READ isCompositingPossible) + /** * @brief The reason why compositing is not possible. Empty String if compositing is possible. */ Q_PROPERTY(QString compositingNotPossibleReason READ compositingNotPossibleReason) + /** * @brief Whether OpenGL has failed badly in the past (crash) and is considered as broken. */ Q_PROPERTY(bool openGLIsBroken READ isOpenGLBroken) + /** * The type of the currently used Scene: * @li @c none No Compositing @@ -110,6 +115,7 @@ class CompositorDBusInterface : public QObject * @li @c gles OpenGL ES 2 */ Q_PROPERTY(QString compositingType READ compositingType) + /** * @brief All currently supported OpenGLPlatformInterfaces. * @@ -120,6 +126,7 @@ class CompositorDBusInterface : public QObject * Values depend on operation mode and compile time options. */ Q_PROPERTY(QStringList supportedOpenGLPlatformInterfaces READ supportedOpenGLPlatformInterfaces) + Q_PROPERTY(bool platformRequiresCompositing READ platformRequiresCompositing) public: explicit CompositorDBusInterface(Compositor *parent); @@ -145,6 +152,7 @@ public Q_SLOTS: * @see isActive */ void suspend(); + /** * @brief Resumes the Compositor if it is currently suspended. * @@ -163,6 +171,7 @@ public Q_SLOTS: * @see isOpenGLBroken */ void resume(); + /** * @brief Used by Compositing KCM after settings change. * @@ -189,14 +198,17 @@ class VirtualDesktopManagerDBusInterface : public QObject * The ids of the virtual desktops are in the range [1, VirtualDesktopManager::maximum()]. */ Q_PROPERTY(uint count READ count NOTIFY countChanged) + /** * The number of rows the virtual desktops will be laid out in */ Q_PROPERTY(uint rows READ rows WRITE setRows NOTIFY rowsChanged) + /** * The id of the virtual desktop which is currently in use. */ Q_PROPERTY(QString current READ current WRITE setCurrent NOTIFY currentChanged) + /** * Whether navigation in the desktop layout wraps around at the borders. */