MirrorHub/construct
0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-11-29 18:22:50 +01:00
Code Issues Releases Wiki Activity

ircd:Ⓜ️:room: Update various comments.

Browse source
This commit is contained in:
Jason Volk 2018-05-04 20:25:06 -07:00
parent 36b43b8607
commit ae8fe6b49e
1 changed files with 15 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
include/ircd/m/room.h
View file

@ -47,7 +47,7 @@ namespace ircd::m
event::idx head_idx(std::nothrow_t, const id::room &); event::idx head_idx(std::nothrow_t, const id::room &);
event::idx head_idx(const id::room &); event::idx head_idx(const id::room &);
// [GET] Current Event depth (non-locking) (one only) // [GET] Current Event depth (non-locking)
int64_t depth(std::nothrow_t, const id::room &); int64_t depth(std::nothrow_t, const id::room &);
int64_t depth(const id::room &); int64_t depth(const id::room &);
@ -206,11 +206,11 @@ struct ircd::m::room::messages
/// Interface to room state. /// Interface to room state.
/// ///
/// This interface focuses specifically on the details of room state. Most of /// This interface focuses specifically on the details of room state. Most of
/// the queries to this interface respond in logarithmic time. Note that all /// the queries to this interface respond in logarithmic time. If an event with
/// iterations are over the state tree. If an event with a state_key is present /// a state_key is present in room::messages but it is not present in
/// in room::messages but it is not present in room::state (state tree) it was /// room::state (state tree) it was accepted into the room but we will not
/// accepted into the room but we will not apply it to our machine, though /// apply it to our machine, though other parties may (this is a
/// other parties may (this is a state-conflict). /// state-conflict).
/// ///
struct ircd::m::room::state struct ircd::m::room::state
{ {
@ -275,12 +275,15 @@ struct ircd::m::room::state
struct ircd::m::room::state::opts struct ircd::m::room::state::opts
{ {
/// If true, the state btree at the present state becomes the source of the /// If true, the state btree at the present state may become the source of
/// data for this interface. This is only significant if no event_id was /// the data for this interface. This is only significant if no event_id
/// specified in the room object, otherwise snapshot is implied at that /// was specified in the room object, otherwise snapshot is implied at that
/// event. If false (and no event_id was given) the faster sequential /// event. If false the faster sequential present state table is used; note
/// present state table is used; note that the present state may change /// that the present state may change while you use this object.
/// while you use this object. ///
/// Also note that passing an event_id (implied snapshot) may still take
/// advantage of a rocksdb snapshot of the present state table and not the
/// btree as an optimization if possible.
bool snapshot {false}; bool snapshot {false};
}; };