From c47a94658ae0701e52ea912861697460784f7638 Mon Sep 17 00:00:00 2001
From: Erik Johnston <erik@matrix.org>
Date: Thu, 15 Oct 2015 11:12:00 +0100
Subject: [PATCH] Mention supported keys

---
 specification/modules/search.rst | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/specification/modules/search.rst b/specification/modules/search.rst
index 87116c2c..665709c8 100644
--- a/specification/modules/search.rst
+++ b/specification/modules/search.rst
@@ -11,11 +11,22 @@ Client behaviour
 {{search_http_api}}
 
 Search Categories
-~~~~~~~~~~~~~~~~~
+-----------------
 
 The search API allows clients to search in different categories of items.
-Currently the only specified category is ``room_events``, which include
-events in rooms the user had joined.
+Currently the only specified category is ``room_events``.
+
+``room_events``
+~~~~~~~~~~~~~~~
+
+This category covers all events in rooms that the user had joined. The search
+is performed on certain keys of certain event types.
+
+The supported keys to search over are:
+
+- ``content.body`` in ``m.room.message``
+- ``content.name`` in ``m.room.name``
+- ``content.topic`` in ``m.room.topic``
 
 Security considerations
 -----------------------