[OMCProcess*] fix docstrings & comments

Author: syntron

OMPython/OMCSession.py

@@ -286,8 +286,8 @@ def getClassNames(self, className=None, recursive=False, qualified=False, sort=F
 
 class OMCPathReal(pathlib.PurePosixPath):
     """
-    Implementation of a basic (PurePosix)Path object which uses OMC as backend. The connection to OMC is provided via a
-    OMCSessionZMQ session object.
+    Implementation of a basic (PurePosix)Path object which uses OMC as backend. The connection to OMC is provided via an
+    OMC instance defined by OMCProcess classes.
 
     PurePosixPath is selected to cover usage of OMC in docker or via WSL. Usage of specialised function could result in
     errors as well as usage on a Windows system due to slightly different definitions (PureWindowsPath).
@@ -301,7 +301,7 @@ def with_segments(self, *pathsegments):
         """
         Create a new OMCPath object with the given path segments.
 
-        The original definition of Path is overridden to ensure session is set.
+        The original definition of Path is overridden to ensure omc_process is set.
         """
         return type(self)(*pathsegments, omc_process=self._omc_process)
 
@@ -539,7 +539,7 @@ def get_cmd(self) -> list[str]:
 
 class OMCSessionZMQ:
     """
-    This class is handling an OMC session. It is a compatibility class for the new schema using OMCProcess* classes.
+    This class is a compatibility layer for the new schema using OMCProcess* classes.
     """
 
     def __init__(
@@ -574,7 +574,7 @@ def escape_str(value: str) -> str:
 
     def omcpath(self, *path) -> OMCPath:
         """
-        Create an OMCPath object based on the given path segments and the current OMC session.
+        Create an OMCPath object based on the given path segments and the current OMC process definition.
         """
         return self.omc_process.omcpath(path)
 
@@ -649,7 +649,7 @@ class OMCProcessMeta(abc.ABCMeta, PostInitCaller):
 
 class OMCProcess(metaclass=OMCProcessMeta):
     """
-    Base class for an OMC session / process via ZMQ. This class contains common functionality for all variants of an
+    Base class for an OMC process started via ZMQ. This class contains common functionality for all variants of an
     OMC process definition.
 
     The main method is sendExpression() which is used to send commands to the OMC process.
@@ -680,7 +680,7 @@ def __init__(
 
         # store variables
         self._timeout = timeout
-        # generate a random string for this session
+        # generate a random string for this instance of OMC
         self._random_string = uuid.uuid4().hex
         # get a temporary directory
         self._temp_dir = pathlib.Path(tempfile.gettempdir())
@@ -764,7 +764,7 @@ def escape_str(value: str) -> str:
 
     def omcpath(self, *path) -> OMCPath:
         """
-        Create an OMCPath object based on the given path segments and the current OMC session.
+        Create an OMCPath object based on the given path segments and the current OMCProcess* class.
         """
 
         # fallback solution for Python < 3.12; a modified pathlib.Path object is used as OMCPath replacement
@@ -1001,7 +1001,7 @@ def get_port(self) -> Optional[str]:
 
     def get_log(self) -> str:
         """
-        Get the log file content of the OMC session.
+        Get the log file content of the OMC instance.
         """
         if self._omc_loghandle is None:
             raise OMCProcessException("Log file not available!")