L2SS-497: Improved comments

tangostationcontrol/tangostationcontrol/devices/beam.py

@@ -60,9 +60,10 @@ class Beam(lofar_device):
     @DebugIt()
     @log_exceptions()
     def download_measures(self):
-        """ Download new measures into /opt/IERS.
+        """ Download new measures tables into /opt/IERS.
         
-            NOTE: This may take a while to complete. """
+            NOTE: This may take a while to complete. You are advised to increase
+                  the timeout of the proxy using `my_device.set_timeout_millis(10000)`. """
 
         return download_measures()
 
@@ -70,7 +71,7 @@ class Beam(lofar_device):
     @DebugIt()
     @log_exceptions()
     def use_measures(self, newdir):
-        """ Activate a new measures directory.
+        """ Activate an installed set of measures tables.
         
             NOTE: This will turn off and restart this device!! """