diff --git a/mouse.c b/mouse.c
index 0d876d1c0..a61d69015 100644
--- a/mouse.c
+++ b/mouse.c
@@ -42,6 +42,8 @@
 /** A table with X and Y coordinates.
  * @field x X coordinate.
  * @field y Y coordinate.
+ * @field buttons Table containing the status of buttons, e.g. field [1] is true
+ *        when button 1 is pressed.
  * @table coords_table
  */