Update usable-by label of methods

Author: SpEcHiDe

pyrogram/methods/business/answer_pre_checkout_query.py

@@ -31,7 +31,9 @@ async def answer_pre_checkout_query(
         
         Use this method to respond to such pre-checkout queries.
 
-        **Note**: The API must receive an answer within 10 seconds after the pre-checkout query was sent.
+        .. note::
+
+            The API must receive an answer within 10 seconds after the pre-checkout query was sent.
 
         .. include:: /_includes/usable-by/bots.rst
 

pyrogram/methods/business/send_gift.py

@@ -35,7 +35,7 @@ async def send_gift(
     ) -> bool:
         """Sends a gift to another user.
 
-        .. include:: /_includes/usable-by/users.rst
+        .. include:: /_includes/usable-by/users-bots.rst
 
         Parameters:
             user_id (``int`` | ``str``):

pyrogram/methods/chats/set_chat_message_auto_delete_time.py

@@ -29,9 +29,11 @@ async def set_chat_message_auto_delete_time(
         message_auto_delete_time: int
     ) -> "types.Message":
         """Changes the message auto-delete or self-destruct (for secret chats) time in a chat.
-        
+
         Requires change_info administrator right in basic groups, supergroups and channels.
 
+        .. include:: /_includes/usable-by/users.rst
+
         Parameters:
             chat_id (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the target chat.

pyrogram/methods/chats/set_chat_protected_content.py

@@ -30,7 +30,7 @@ async def set_chat_protected_content(
     ) -> bool:
         """Set the chat protected content setting.
 
-        .. include:: /_includes/usable-by/users-bots.rst
+        .. include:: /_includes/usable-by/users.rst
 
         Parameters:
             chat_id (``int`` | ``str``):

pyrogram/methods/chats/set_slow_mode.py

@@ -30,7 +30,7 @@ async def set_slow_mode(
     ) -> bool:
         """Set the slow mode interval for a chat.
 
-        .. include:: /_includes/usable-by/users-bots.rst
+        .. include:: /_includes/usable-by/users.rst
 
         Parameters:
             chat_id (``int`` | ``str``):

pyrogram/methods/users/get_default_emoji_statuses.py

@@ -29,7 +29,7 @@ async def get_default_emoji_statuses(
     ) -> List["types.EmojiStatus"]:
         """Get the default emoji statuses.
 
-        .. include:: /_includes/usable-by/users-bots.rst
+        .. include:: /_includes/usable-by/users.rst
 
         Returns:
             List of :obj:`~pyrogram.types.EmojiStatus`: On success, a list of emoji statuses is returned.

pyrogram/methods/users/set_username.py

@@ -27,17 +27,18 @@ async def set_username(
         self: "pyrogram.Client",
         username: Optional[str]
     ) -> bool:
-        """Set your own username.
+        """Changes the editable username of the current user.
 
-        This method only works for users, not bots. Bot usernames must be changed via Bot Support or by recreating
-        them from scratch using BotFather. To set a channel or supergroup username you can use
-        :meth:`~pyrogram.Client.set_chat_username`.
+        This method only works for users, not bots.
+        Bot usernames must be changed via Bot Support or by recreating them from scratch using BotFather.
+        To set a channel or supergroup username you can use :meth:`~pyrogram.Client.set_chat_username`.
 
         .. include:: /_includes/usable-by/users.rst
 
         Parameters:
             username (``str`` | ``None``):
                 Username to set. "" (empty string) or None to remove it.
+                The username can't be completely removed if there is another active or disabled username.
 
         Returns:
             ``bool``: True on success.

pyrogram/methods/users/update_profile.py

@@ -23,6 +23,7 @@
 class UpdateProfile:
     async def update_profile(
         self: "pyrogram.Client",
+        *,
         first_name: str = None,
         last_name: str = None,
         bio: str = None
@@ -35,14 +36,15 @@ async def update_profile(
 
         Parameters:
             first_name (``str``, *optional*):
-                The new first name.
+                The new first name; 1-64 characters.
 
             last_name (``str``, *optional*):
-                The new last name.
+                The new last name; 1-64 characters.
                 Pass "" (empty string) to remove it.
 
             bio (``str``, *optional*):
-                The new bio, also known as "about". Max 70 characters.
+                Changes the bio of the current user.
+                Max ``intro_description_length_limit`` characters without line feeds.
                 Pass "" (empty string) to remove it.
 
         Returns:

pyrogram/types/bots_and_keyboards/inline_keyboard_button.py

@@ -73,12 +73,17 @@ class InlineKeyboardButton(Object):
 
         callback_game (:obj:`~pyrogram.types.CallbackGame`, *optional*):
             Description of the game that will be launched when the user presses the button.
-            **NOTE**: This type of button **must** always be the first button in the first row.
+
+            .. note::
+
+                This type of button **must** always be the first button in the first row.
         
         pay (``bool``, *optional*):
             Specify True, to send a Pay button. Substrings "⭐" and "XTR" in the buttons's text will be replaced with a Telegram Star icon.
 
-            **NOTE**: This type of button **must** always be the first button in the first row and can only be used in invoice messages.
+            .. note::
+            
+                This type of button **must** always be the first button in the first row and can only be used in invoice messages.
 
         callback_data_with_password (``bytes``, *optional*):
             A button that asks for the 2-step verification password of the current user and then sends a callback query to a bot Data to be sent to the bot via a callback query.

pyrogram/types/bots_and_keyboards/login_url.py

@@ -34,9 +34,10 @@ class LoginUrl(Object):
             be opened. The data added is the same as described in
             `Receiving authorization data <https://core.telegram.org/widgets/login#receiving-authorization-data>`.
 
-            **NOTE**: You **must** always check the hash of the received data to verify the authentication and the
-            integrity of the data as described in
-            `Checking authorization <https://core.telegram.org/widgets/login#checking-authorization>`_.
+            .. note::
+            
+                You **must** always check the hash of the received data to verify the authentication
+                and the integrity of the data as described in `Checking authorization <https://core.telegram.org/widgets/login#checking-authorization>`_.
 
         forward_text (``str``, *optional*):
             New text of the button in forwarded messages.