From 8ed3ddba31679ee5be899c4dfcdcdc7c58d60664 Mon Sep 17 00:00:00 2001
From: Lonami Exo <totufals@hotmail.com>
Date: Mon, 19 Nov 2018 08:35:18 +0100
Subject: [PATCH] Clarify iter_participants filter parameter in the docs

---
 telethon/client/chats.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/telethon/client/chats.py b/telethon/client/chats.py
index f62305cd..ac4623f2 100644
--- a/telethon/client/chats.py
+++ b/telethon/client/chats.py
@@ -34,6 +34,12 @@ class ChatMethods(UserMethods):
                 Note that you might not have permissions for some filter.
                 This has no effect for normal chats or users.
 
+                .. note::
+
+                    The filter :tl:`ChannelParticipantsBanned` will return
+                    *restricted* users. If you want *banned* users you should
+                    use :tl:`ChannelParticipantsKicked` instead.
+
             aggressive (`bool`, optional):
                 Aggressively looks for all participants in the chat.