From 64ec26850e4b6b86064fbe8eb186f992d00202e4 Mon Sep 17 00:00:00 2001
From: Dan <14043624+delivrance@users.noreply.github.com>
Date: Fri, 28 Dec 2018 15:16:46 +0100
Subject: [PATCH] Document save_file

---
 docs/source/pyrogram/Client.rst |  2 +-
 pyrogram/client/client.py       | 51 +++++++++++++++++++++++++++++++--
 2 files changed, 49 insertions(+), 4 deletions(-)

diff --git a/docs/source/pyrogram/Client.rst b/docs/source/pyrogram/Client.rst
index 179910a3..5f402c65 100644
--- a/docs/source/pyrogram/Client.rst
+++ b/docs/source/pyrogram/Client.rst
@@ -19,7 +19,7 @@ Utilities
     remove_handler
     send
     resolve_peer
-    download_media
+    save_file
 
 Decorators
 ----------
diff --git a/pyrogram/client/client.py b/pyrogram/client/client.py
index 226f783c..673fc33c 100644
--- a/pyrogram/client/client.py
+++ b/pyrogram/client/client.py
@@ -1116,9 +1116,9 @@ class Client(Methods, BaseClient):
                      peer_id: Union[int, str]):
         """Use this method to get the InputPeer of a known peer_id.
 
-        This is a utility method intended to be used only when working with Raw Functions (i.e: a Telegram API method
-        you wish to use which is not available yet in the Client class as an easy-to-use method), whenever an InputPeer
-        type is required.
+        This is a utility method intended to be used **only** when working with Raw Functions (i.e: a Telegram API
+        method you wish to use which is not available yet in the Client class as an easy-to-use method), whenever an
+        InputPeer type is required.
 
         Args:
             peer_id (``int`` | ``str``):
@@ -1191,6 +1191,51 @@ class Client(Methods, BaseClient):
                   file_part: int = 0,
                   progress: callable = None,
                   progress_args: tuple = ()):
+        """Use this method to upload a file onto Telegram servers, without actually sending the message to anyone.
+
+        This is a utility method intended to be used **only** when working with Raw Functions (i.e: a Telegram API
+        method you wish to use which is not available yet in the Client class as an easy-to-use method), whenever an
+        InputFile type is required.
+
+        Args:
+            path (``str``):
+                The path of the file you want to upload that exists on your local machine.
+
+            file_id (``int``, *optional*):
+                In case a file part expired, pass the file_id and the file_part to retry uploading that specific chunk.
+
+            file_part (``int``, *optional*):
+                In case a file part expired, pass the file_id and the file_part to retry uploading that specific chunk.
+
+            progress (``callable``, *optional*):
+                Pass a callback function to view the upload progress.
+                The function must take *(client, current, total, \*args)* as positional arguments (look at the section
+                below for a detailed description).
+
+            progress_args (``tuple``, *optional*):
+                Extra custom arguments for the progress callback function. Useful, for example, if you want to pass
+                a chat_id and a message_id in order to edit a message with the updated progress.
+
+        Other Parameters:
+            client (:obj:`Client <pyrogram.Client>`):
+                The Client itself, useful when you want to call other API methods inside the callback function.
+
+            current (``int``):
+                The amount of bytes uploaded so far.
+
+            total (``int``):
+                The size of the file.
+
+            *args (``tuple``, *optional*):
+                Extra custom arguments as defined in the *progress_args* parameter.
+                You can either keep *\*args* or add every single extra argument in your function signature.
+
+        Returns:
+            On success, the uploaded file is returned in form of an InputFile object.
+
+        Raises:
+            :class:`Error <pyrogram.Error>` in case of a Telegram RPC error.
+        """
         part_size = 512 * 1024
         file_size = os.path.getsize(path)