Improve docstrings

Author: ondras12345

OMPython/ModelicaSystem.py

@@ -113,9 +113,7 @@ def __getitem__(self, index: int):
 
 
 class ModelicaSystemCmd:
-    """
-    Execute a simulation by running the compiled model.
-    """
+    """A compiled model executable."""
 
     def __init__(self, runpath: pathlib.Path, modelname: str, timeout: Optional[float] = None) -> None:
         self._runpath = pathlib.Path(runpath).resolve().absolute()
@@ -851,10 +849,10 @@ def simulate(self,
 
         Args:
             resultfile: Path to a custom result file
-            simflags: String of space separated simulation runtime flags.
+            simflags: String of extra command line flags for the model binary.
               This argument is deprecated, use simargs instead.
             simargs: Dict with simulation runtime flags.
-            timeout: Execution timeout in seconds.
+            timeout: Maximum execution time in seconds.
 
         Examples:
             mod.simulate()
@@ -1244,10 +1242,10 @@ def linearize(self, lintime: Optional[float] = None, simflags: Optional[str] = N
 
         Args:
             lintime: Override "stopTime" value.
-            simflags: A string of extra command line flags for the model
-              binary. - depreciated in favor of simargs
+            simflags: String of extra command line flags for the model binary.
+              This argument is deprecated, use simargs instead.
             simargs: A dict with command line flags and possible options; example: "simargs={'csvInput': 'a.csv'}"
-            timeout: Execution timeout in seconds.
+            timeout: Maximum execution time in seconds.
 
         Returns:
             A LinearizationResult object is returned. This allows several