show which bits are set in global keymask

1 files changed, 24 insertions, 3 deletions

diff --git a/libopie2/opiecore/oinputsystem.h b/libopie2/opiecore/oinputsystem.h
index 9020bc1..7919610 100644
--- a/libopie2/opiecore/oinputsystem.h
+++ b/libopie2/opiecore/oinputsystem.h
@@ -73,13 +73,13 @@ class OInputSystem : public QObject
     /**
      * @internal Rebuild the internal interface database
      * @note Sometimes it might be useful to call this from client code,
      */
     void synchronize();
     /**
-     * @internal desctructor
+     * @internal destructor
      */    
      ~OInputSystem();
  
  protected:
     OInputSystem();
     
@@ -94,17 +94,38 @@ class OInputDevice : public QObject
     OInputDevice( QObject* parent, const char* name = 0 );
     ~OInputDevice();
 
     #include "oinputsystemenums.h"    
     
   public:
+    /**
+     * @returns the identity string of this input device
+     */
     QString identity() const;
+    /**
+     * @returns the path of this input device
+     */
     QString path() const;
+    /**
+     * @returns a unique identifier for this input device
+     * @note Only a few devices support this
+     */
     QString uniq() const;
-    bool    hasFeature( Feature ) const;
-    bool    isHeld( Key ) const;
+    /**
+     * @returns whether a certain @a Feature is being supported by this device
+     */
+    bool hasFeature( Feature ) const;
+    /**
+     * @returns whether a given @a Key or Button is being held at the moment
+     */
+    bool isHeld( Key ) const;
+    /**
+     * @internal
+     * @returns a string containing a printable form of the global keymask
+     */
+    QString globalKeyMask() const;
     
   private:
     int _fd;
     input_id _id;
 
 };