Partition,Instance: add EmitIdle() documentation

src/Instance.hxx

@@ -143,6 +143,11 @@ struct Instance final
 		event_loop.Break();
 	}
 
+	/**
+	 * Emit an "idle" event to all clients of all partitions.
+	 *
+	 * This method can be called from any thread.
+	 */
 	void EmitIdle(unsigned mask) noexcept {
 		idle_monitor.OrMask(mask);
 	}

src/Partition.hxx

@@ -80,6 +80,12 @@ struct Partition final : QueueListener, PlayerListener, MixerListener {
 		global_events.OrMask(mask);
 	}
 
+	/**
+	 * Emit an "idle" event to all clients of this partition.
+	 *
+	 * This method is not thread-safe and may only be called from
+	 * the main thread.
+	 */
 	void EmitIdle(unsigned mask) noexcept;
 
 	/**