diff --git a/Useful-console-command-examples.md b/Useful-console-command-examples.md
index dfe1ab8..8a2614b 100644
--- a/Useful-console-command-examples.md
+++ b/Useful-console-command-examples.md
@@ -48,13 +48,16 @@ List room events, optionally restricting to the given type or the given mxid. Ma
 Get complete room state according to the server
 
 ### `room state rebuild <room>`
-Rebuild the room state from ? and doing ?, required if ?
+Manually rebuild the _present_ `room state` from the `room state space`. Required if the present state resolves incorrectly or falls out of sync due to bugs or missing functionality in the server.
 
 ### `room state space rebuild <room>`
-Rebuild harder. It will also ? and possibly ?.
+Manually rebuild the _higher dimension_ `room state space` table from the `room events` table. Required if any state event is missing from this table, but is in the `room events` (rare).
 
-### `room state space <room> <event_type>`
-Show the state of a given event_type-state of a room, like `m.room.name`.
+### `room state space <room> [event_type] [state_key]`
+Show all possible states for a given `(type,state_key)` "cell"
+- The state which is selected for the present-state is marked with an `*` asterisk.
+- A state which fails one of the three authentication phases is marked with an `X` and a reason string may be present on the right.
+- A state which has been redacted is marked with an `R`
 
 ### `room members <room>`
 Show members of a room according to the server.