Document how the "not_foo" keys interact with the "foo" keys

api/client-server/v2_alpha/definitions/event_filter.json

@@ -17,7 +17,7 @@
     "not_types": {
       "type": "array",
       "description":
-        "A list of event types to exclude. If this list is absent then no event types are excluded.",
+        "A list of event types to exclude. If this list is absent then no event types are excluded. A matching type will be excluded even if it is listed in the 'types' filter",
       "items": {
         "type": "string"
       }
@@ -33,7 +33,7 @@
     "not_senders": {
       "type": "array",
       "description":
-        "A list of sender IDs to exclude. If this list is absent then no senders are excluded.",
+        "A list of sender IDs to exclude. If this list is absent then no senders are excluded. A matching sender will be excluded even if it is listed in the 'senders' filter",
       "items": {
         "type": "string"
       }

api/client-server/v2_alpha/definitions/room_event_filter.json

@@ -1,5 +1,6 @@
 {
   "type": "object",
+  "allOf": [{"$ref": "definitions/event_filter.json"}],
   "properties": {
     "rooms": {
       "type": "array",
@@ -12,7 +13,7 @@
     "not_rooms": {
       "type": "array",
       "description":
-        "A list of room IDs to exclude. If this list is absent then no rooms are excluded.",
+        "A list of room IDs to exclude. If this list is absent then no rooms are excluded. A matching room will be excluded even if it is listed in the 'rooms' filter",
       "items": {
         "type": "string"
       }