mirror of
https://github.com/element-hq/synapse.git
synced 2025-03-31 03:45:13 +00:00
Clarify docs for some room state functions (#16950)
State *before* an event is different to state *after* that event, and people tend to assume the wrong one.
This commit is contained in:
parent
42fa47a2a4
commit
9635822cc1
2 changed files with 6 additions and 3 deletions
1
changelog.d/16950.misc
Normal file
1
changelog.d/16950.misc
Normal file
|
@ -0,0 +1 @@
|
||||||
|
Clarify docs for some room state functions.
|
|
@ -273,8 +273,10 @@ class StateStorageController:
|
||||||
await_full_state: bool = True,
|
await_full_state: bool = True,
|
||||||
) -> Dict[str, StateMap[str]]:
|
) -> Dict[str, StateMap[str]]:
|
||||||
"""
|
"""
|
||||||
Get the state dicts corresponding to a list of events, containing the event_ids
|
Get the room states after each of a list of events.
|
||||||
of the state events (as opposed to the events themselves)
|
|
||||||
|
For each event in `event_ids`, the result contains a map from state tuple
|
||||||
|
to the event_ids of the state event (as opposed to the events themselves).
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
event_ids: events whose state should be returned
|
event_ids: events whose state should be returned
|
||||||
|
@ -347,7 +349,7 @@ class StateStorageController:
|
||||||
await_full_state: bool = True,
|
await_full_state: bool = True,
|
||||||
) -> StateMap[str]:
|
) -> StateMap[str]:
|
||||||
"""
|
"""
|
||||||
Get the state dict corresponding to a particular event
|
Get the state dict corresponding to the state after a particular event
|
||||||
|
|
||||||
Args:
|
Args:
|
||||||
event_id: event whose state should be returned
|
event_id: event whose state should be returned
|
||||||
|
|
Loading…
Add table
Reference in a new issue