Add more comments

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

1 files changed, 19 insertions, 0 deletions

diff --git a/src/synaptics.h b/src/synaptics.h
index 0ba8ab4..c75239d 100644
--- a/src/synaptics.h
+++ b/src/synaptics.h
@@ -88,15 +88,34 @@ void SynapticsSetTimer(SynapticsPrivate *priv, unsigned int now, unsigned int de
  * Implemented-by: core
  */
 void SynapticsFinishPreInit(SynapticsPrivate * priv);
+
+/**
+ * Query the hardware for properties, dimensions, etc. Returns 1 on success
+ * or 0 on failure.
+ * Implemented-by: core
+ */
 Bool SynapticsQueryHardware(SynapticsPrivate *priv, int fd);
+
+/**
+ * Given a protocol string and/or device file, return the backend protocol
+ * operations and the effectively used device.
+ * Implemented-by: core
+ */
 struct SynapticsProtocolOperations*
 SynapticsGetDeviceProtocolOps(SynapticsPrivate *priv,
                               const char *proto,
                               const char *device,
                               char **used_device);
+/**
+ * Driver-internal timer callback. Must be called from the front-end
+ * specific timer handler.
+ * Implemented-by: core
+ */
 unsigned int SynapticsTimerFunc(SynapticsPrivate *priv, unsigned int now);
+
 /**
  * Return the current time in milliseconds.
+ * Implemented-by: frontend
  */
 unsigned int SynapticsGetCurrentMillis(void);