put back returns function comments

Author: brentru

adafruit_fona/adafruit_fona.py

@@ -497,7 +497,7 @@ def send_sms(self, phone_number, message):
         return True
 
     def num_sms(self, sim_storage=True):
-        """Number of SMS messages stored in memory.
+        """Returns the number of SMS messages stored in memory.
         :param bool sim_storage: SMS storage on the SIM, otherwise internal storage on FONA chip.
 
         """
@@ -636,7 +636,7 @@ def get_socket(self):
         return allocated_socket
 
     def remote_ip(self, sock_num):
-        """IP address of the remote server.
+        """Returns the IP address of the remote server.
         :param int sock_num: Desired socket.
 
         """
@@ -651,7 +651,7 @@ def remote_ip(self, sock_num):
         return self._buf
 
     def socket_status(self, sock_num):
-        """Socket connection status, False if not connected to remote server.
+        """Returns the socket connection status, False if not connected.
         :param int sock_num: Desired socket number.
 
         """
@@ -681,7 +681,7 @@ def socket_status(self, sock_num):
         return True
 
     def socket_available(self, sock_num):
-        """Amount of bytes available to be read from the socket.
+        """Returns the amount of bytes available to be read from the socket.
         :param int sock_num: Desired socket to return bytes available from.
 
         """

adafruit_fona/fona_3g.py

@@ -193,7 +193,7 @@ def get_host_by_name(self, hostname):
         return self._buf
 
     def get_socket(self):
-        """Obtains an unused socket."""
+        """Returns an unused socket."""
         if self._debug:
             print("*** Get socket")
 
@@ -254,7 +254,8 @@ def socket_connect(self, sock_num, dest, port, conn_mode=0):
         return True
 
     def remote_ip(self, sock_num):
-        """IP address of remote connection."""
+        """Returns the IP address of the remote connection.
+        """
         self._read_line()
         assert (
             sock_num < FONA_MAX_SOCKETS
@@ -313,7 +314,7 @@ def socket_write(self, sock_num, buffer, timeout=120000):
         return True
 
     def socket_status(self, sock_num):
-        """Socket status, True if connected. False otherwise.
+        """Returns socket status, True if connected. False otherwise.
         :param int sock_num: Desired socket number.
 
         """