diff --git a/objects/client.c b/objects/client.c
index 06bd1ad3..2c3c067e 100644
--- a/objects/client.c
+++ b/objects/client.c
@@ -2640,7 +2640,7 @@ client_class_setup(lua_State *L)
                             (lua_class_propfunc_t) luaA_client_get_client_shape_clip,
                             NULL);
 
-    /** when a client gains focus
+    /** When a client gains focus.
      * @signal .focus
      */
     signal_add(&client_class.signals, "focus");
@@ -2868,11 +2868,12 @@ client_class_setup(lua_State *L)
      * @signal request::urgent
      */
     signal_add(&client_class.signals, "request::urgent");
-    /** when client is tagged
+    /** When a client gets tagged.
      * @signal .tagged
+     * @tag t The tag object.
      */
     signal_add(&client_class.signals, "tagged");
-    /** when a client looses focus
+    /** When a client gets unfocused.
      * @signal .unfocus
      */
     signal_add(&client_class.signals, "unfocus");
@@ -2880,8 +2881,9 @@ client_class_setup(lua_State *L)
      * @signal .unmanage
      */
     signal_add(&client_class.signals, "unmanage");
-    /** when client looses tag
+    /** When a client gets untagged.
      * @signal .untagged
+     * @tag t The tag object.
      */
     signal_add(&client_class.signals, "untagged");
 }
diff --git a/objects/tag.c b/objects/tag.c
index b694079a..152f14d3 100644
--- a/objects/tag.c
+++ b/objects/tag.c
@@ -395,12 +395,14 @@ tag_class_setup(lua_State *L)
      * @signal request::select
      */
     signal_add(&tag_class.signals, "request::select");
-    /**
+    /** When a client gets tagged with this tag.
      * @signal tagged
+     * @client c The tagged client.
      */
     signal_add(&tag_class.signals, "tagged");
-    /**
+    /** When a client gets untagged with this tag.
      * @signal untagged
+     * @client c The untagged client.
      */
     signal_add(&tag_class.signals, "untagged");
 }