Rename RequestsToJoinListener, fix doc comment

bindings/matrix-sdk-ffi/src/room.rs

@@ -917,7 +917,7 @@ impl Room {
     /// subscription.
     pub async fn subscribe_to_join_requests(
         self: Arc<Self>,
-        listener: Box<dyn RequestsToJoinListener>,
+        listener: Box<dyn JoinRequestsListener>,
     ) -> Result<Arc<TaskHandle>, ClientError> {
         let stream = self.inner.subscribe_to_join_requests().await?;
 
@@ -950,7 +950,7 @@ impl From<matrix_sdk::room::request_to_join::JoinRequest> for JoinRequest {
 
 /// A listener for receiving new requests to a join a room.
 #[matrix_sdk_ffi_macros::export(callback_interface)]
-pub trait RequestsToJoinListener: Send + Sync {
+pub trait JoinRequestsListener: Send + Sync {
     fn call(&self, join_requests: Vec<JoinRequest>);
 }
 

crates/matrix-sdk/src/room/mod.rs

@@ -3208,8 +3208,12 @@ impl Room {
         ObservableLiveLocation::new(&self.client, self.room_id())
     }
 
-    /// Helper to requests to join this `Room`. It returns both a list with the
-    /// initial items and any new request to join received.
+    /// Helper to requests to join this `Room`.
+    ///
+    /// The current requests to join the room will be emitted immediately
+    /// when subscribing. When a new membership event is received, a request is
+    /// marked as seen or there is a limited sync, a new set of requests
+    /// will be emitted.
     pub async fn subscribe_to_join_requests(&self) -> Result<impl Stream<Item = Vec<JoinRequest>>> {
         let this = Arc::new(self.clone());