Function comment converted to correct format

Author: mark-edgeworth

packages/mbed-greentea/setup.py

@@ -32,10 +32,16 @@
 OWNER_NAMES = 'Anna Bridge, Azim Khan'
 OWNER_EMAILS = '[email protected], [email protected]'
 
-# Utility function to cat in a file (used for the README)
+
 def read(fname):
+    """
+    Utility function to cat in a file (used for the README)
+    @param fname: the name of the file to read, relative to the directory containing this file
+    @return: The string content of the opened file
+    """
     return open(os.path.join(os.path.dirname(__file__), fname), encoding="utf-8").read()
 
+
 setup(name='mbed-greentea',
       version='1.7.1',
       description=DESCRIPTION,

packages/mbed-host-tests/setup.py

@@ -32,10 +32,15 @@
 OWNER_EMAILS = '[email protected], [email protected]'
 
 
-# Utility function to cat in a file (used for the README)
 def read(fname):
+    """
+    Utility function to cat in a file (used for the README)
+    @param fname: the name of the file to read, relative to the directory containing this file
+    @return: The string content of the opened file
+    """
     return open(os.path.join(os.path.dirname(__file__), fname), encoding="utf8").read()
 
+
 setup(name='mbed-host-tests',
       version='1.5.7',
       description=DESCRIPTION,

packages/mbed-ls/setup.py

@@ -29,10 +29,16 @@
 OWNER_EMAILS = '[email protected], [email protected]'
 
 
-# Utility function to cat in a file (used for the README)
+
 def read(fname):
+    """
+    Utility function to cat in a file (used for the README)
+    @param fname: the name of the file to read, relative to the directory containing this file
+    @return: The string content of the opened file
+    """
     return open(os.path.join(os.path.dirname(__file__), fname), encoding="utf8").read()
 
+
 setup(name='mbed-ls',
       version='1.7.7',
       description=DESCRIPTION,