xtriggers: docstring formatting fixes

cylc/flow/xtriggers/echo.py

@@ -30,16 +30,16 @@ def echo(*args, **kwargs) -> Tuple:
         *args: Print to stdout.
         **kwargs: Print to stdout, and return as output.
 
+    Returns:
+        (True/False, kwargs)
+
     Examples:
 
         >>> echo('Breakfast Time', succeed=True, egg='poached')
         echo: ARGS: ('Breakfast Time',)
         echo: KWARGS: {'succeed': True, 'egg': 'poached'}
         (True, {'succeed': True, 'egg': 'poached'})
 
-    Returns
-        (True/False, kwargs)
-
     """
     print("echo: ARGS:", args)
     print("echo: KWARGS:", kwargs)

cylc/flow/xtriggers/wall_clock.py

@@ -34,6 +34,10 @@ def wall_clock(offset: str = 'PT0S', sequential: bool = True):
             ISO 8601 interval to wait after the cycle point is reached in real
             time before triggering. May be negative, in which case it will
             trigger before the real time reaches the cycle point.
+        sequential:
+            Wall-clock xtriggers are run sequentially by default.
+            See :ref:`Sequential Xtriggers` for more details.
+
     """
     # NOTE: This is just a placeholder for the actual implementation.
     # This is only used for validating the signature and for autodocs.

cylc/flow/xtriggers/workflow_state.py

@@ -54,6 +54,7 @@ def workflow_state(
             The task status required for this xtrigger to be satisfied.
         message:
             The custom task output required for this xtrigger to be satisfied.
+
             .. note::
 
                This cannot be specified in conjunction with ``status``.

cylc/flow/xtriggers/xrandom.py

@@ -45,6 +45,19 @@ def xrandom(
             Used to allow users to specialize the trigger with extra
             parameters.
 
+    Returns:
+        tuple: (satisfied, results)
+
+        satisfied:
+            True if ``satisfied`` else ``False``.
+        results:
+            A dictionary containing the following keys:
+
+            ``COLOR``
+                A random colour (e.g. red, orange, ...).
+            ``SIZE``
+                A random size (e.g. small, medium, ...).
+
     Examples:
         If the percent is zero, it returns that the trigger condition was
         not satisfied, and an empty dictionary.
@@ -74,19 +87,6 @@ def xrandom(
         >>> xrandom(99.99, 0)
         (True, {'COLOR': 'orange', 'SIZE': 'small'})
 
-    Returns:
-        tuple: (satisfied, results)
-
-        satisfied:
-            True if ``satisfied`` else ``False``.
-        results:
-            A dictionary containing the following keys:
-
-            ``COLOR``
-                A random colour (e.g. red, orange, ...).
-            ``SIZE``
-                A random size (e.g. small, medium, ...).
-
     """
     sleep(float(secs))
     results = {}