small docstring and comment updates

Author: murrayrm

control/statesp.py

@@ -1575,7 +1575,7 @@ def ss(*args, **kwargs):
 
     Returns
     -------
-    out: StateSpace
+    out : StateSpace
         Linear input/output system.
 
     Other Parameters
@@ -1591,24 +1591,6 @@ def ss(*args, **kwargs):
     name : string, optional
         System name (used for specifying signals). If unspecified, a generic
         name <sys[id]> is generated with a unique integer id.
-    remove_useless_states : bool, optional
-        If `True`, remove states that have no effect on the input/output
-        dynamics.  If not specified, the value is read from
-        `config.defaults['statesp.remove_useless_states']` (default = False).
-    method : str, optional
-        Set the method used for converting a transfer function to a state
-        space system.  Current methods are 'slycot' and 'scipy'.  If set to
-        None (default), try 'slycot' first and then 'scipy' (SISO only).
-
-    Returns
-    -------
-    out: StateSpace
-        Linear input/output system.
-
-    Returns
-    -------
-    out : StateSpace
-        Linear input/output system.
 
     Raises
     ------

control/xferfcn.py

@@ -194,7 +194,6 @@ def __init__(self, *args, **kwargs):
                                 % type(args[0]))
             num = args[0].num
             den = args[0].den
-            # TODO: copy over signal names
 
         else:
             raise TypeError("Needs 1, 2 or 3 arguments; received %i."