Merge pull request pyrogram#333 from pyrogram/fixes

Various fixes and additions to the documentation

Author: delivrance

compiler/error/source/400_BAD_REQUEST.tsv

@@ -130,4 +130,5 @@ CHANNELS_TOO_MUCH	You have joined too many channels or supergroups
 ADMIN_RANK_INVALIDThe custom administrator title is invalid or is longer than 16 characters
 ADMIN_RANK_EMOJI_NOT_ALLOWEDEmojis are not allowed in custom administrator titles
 FILE_REFERENCE_EMPTYThe file reference is empty
-FILE_REFERENCE_INVALIDThe file reference is invalid
+FILE_REFERENCE_INVALIDThe file reference is invalid
+REPLY_MARKUP_TOO_LONGThe reply markup is too long

docs/source/faq.rst

@@ -253,6 +253,19 @@ contact people using official apps. The answer is the same for Pyrogram too and
 for usernames, meeting them in a common group, have their phone contacts saved or getting a message mentioning them,
 either a forward or a mention in the message text.
 
+Code hangs when I stop, restart, add/remove_handler
+---------------------------------------------------
+
+You tried to ``.stop()``, ``.restart()``, ``.add_handler()`` or ``.remove_handler()`` *inside* a running handler, but
+that can't be done because the way Pyrogram deals with handlers would make it hang.
+
+When calling one of the methods above inside an event handler, Pyrogram needs to wait for all running handlers to finish
+in order to safely continue. In other words, since your handler is blocking the execution by waiting for the called
+method to finish and since Pyrogram needs to wait for your handler to finish, you are left with a deadlock.
+
+The solution to this problem is to pass ``block=False`` to such methods so that they return immediately and the actual
+code called asynchronously.
+
 UnicodeEncodeError: '<encoding>' codec can't encode …
 -----------------------------------------------------
 

docs/source/topics/mtproto-vs-botapi.rst

@@ -73,12 +73,6 @@ HTTP Bot API. Using Pyrogram you can:
  - :guilabel:`--` The Bot API types often miss some useful information about Telegram entities and some of the
  methods are limited as well.
 
-.. hlist::
- :columns: 1
-
- - :guilabel:`+` **Get information about any public chat by usernames, even if not a member**
- - :guilabel:`--` The Bot API simply doesn't support this
-
 .. hlist::
  :columns: 1
 

pyrogram/client/handlers/disconnect_handler.py

@@ -21,7 +21,7 @@
 
 class DisconnectHandler(Handler):
  """The Disconnect handler class. Used to handle disconnections. It is intended to be used with
- :meth:~Client.add_handler`
+ :meth:`~Client.add_handler`
 
  For a nicer way to register this handler, have a look at the
  :meth:`~Client.on_disconnect` decorator.