docstring and signature tweaks

murrayrm · murrayrm · commit 03f0e28b804c · 2021-08-25T21:54:03.000-07:00
diff --git a/control/timeresp.py b/control/timeresp.py
@@ -621,7 +621,7 @@ def shape_matches(s_legal, s_actual):
 
 
 # Forced response of a linear system
-def forced_response(sys, T=None, U=0., X0=0., issiso=False, transpose=False,
+def forced_response(sys, T=None, U=0., X0=0., transpose=False,
                     interpolate=False, return_x=None, squeeze=None):
     """Simulate the output of a linear system.
 
diff --git a/doc/conventions.rst b/doc/conventions.rst
@@ -134,13 +134,12 @@ Types:
     * **Arguments** can be **arrays**, **matrices**, or **nested lists**.
     * **Return values** are **arrays** (not matrices).
 
-The time vector is either 1D, or 2D with shape (1, n)::
+The time vector is a 1D array with shape (n, )::
 
-      T = [[t1,     t2,     t3,     ..., tn    ]]
+      T = [t1,     t2,     t3,     ..., tn    ]
 
 Input, state, and output all follow the same convention. Columns are different
-points in time, rows are different components. When there is only one row, a
-1D object is accepted or returned, which adds convenience for SISO systems::
+points in time, rows are different components::
 
       U = [[u1(t1), u1(t2), u1(t3), ..., u1(tn)]
            [u2(t1), u2(t2), u2(t3), ..., u2(tn)]
@@ -153,6 +152,9 @@ points in time, rows are different components. When there is only one row, a
 So, U[:,2] is the system's input at the third point in time; and U[1] or U[1,:]
 is the sequence of values for the system's second input.
 
+When there is only one row, a 1D object is accepted or returned, which adds
+convenience for SISO systems:
+
 The initial conditions are either 1D, or 2D with shape (j, 1)::
 
      X0 = [[x1]
@@ -230,27 +232,29 @@ on standard configurations.
 
 Selected variables that can be configured, along with their default values:
 
-  * freqplot.dB (False): Bode plot magnitude plotted in dB (otherwise powers of 10)
+  * freqplot.dB (False): Bode plot magnitude plotted in dB (otherwise powers
+    of 10)
     
   * freqplot.deg (True): Bode plot phase plotted in degrees (otherwise radians)
     
-  * freqplot.Hz (False): Bode plot frequency plotted in Hertz (otherwise rad/sec)
+  * freqplot.Hz (False): Bode plot frequency plotted in Hertz (otherwise
+    rad/sec)
     
   * freqplot.grid (True): Include grids for magnitude and phase plots
     
   * freqplot.number_of_samples (1000): Number of frequency points in Bode plots
     
-  * freqplot.feature_periphery_decade (1.0): How many decades to include in the
-    frequency range on both sides of features (poles, zeros).
+  * freqplot.feature_periphery_decade (1.0): How many decades to include in
+    the frequency range on both sides of features (poles, zeros).
 
-  * statesp.use_numpy_matrix (True): set the return type for state space matrices to
-    `numpy.matrix` (verus numpy.ndarray)
+  * statesp.use_numpy_matrix (True): set the return type for state space
+    matrices to `numpy.matrix` (verus numpy.ndarray)
 
-  * statesp.default_dt and xferfcn.default_dt (None): set the default value of dt when
-    constructing new LTI systems
+  * statesp.default_dt and xferfcn.default_dt (None): set the default value
+    of dt when constructing new LTI systems
 
-  * statesp.remove_useless_states (True): remove states that have no effect on the
-    input-output dynamics of the system
+  * statesp.remove_useless_states (True): remove states that have no effect
+    on the input-output dynamics of the system
 
 Additional parameter variables are documented in individual functions
 
